> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.empiriolabs.ai/models/pixverse-edit/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.empiriolabs.ai/_mcp/server. # Pixverse Edit > Six video transformations in one model: prompt editing, restyling, subject swap, motion transfer, upscaling, and generated sound effects. ![Pixverse Edit](https://media.empiriolabs.ai/model-logos/pixverse-edit.png) [PixVerse](/providers/pixverse) · Video Generation `POST /v1/videos/generations` Six video transformations in one model: prompt editing, restyling, subject swap, motion transfer, upscaling, and generated sound effects. ## At a glance | Field | Value | | ------------------- | ------------------------------------------------------------ | | Model id | `pixverse-edit` | | Model release date | - | | Input modalities | Text, Video, Image | | Output modalities | Video | | Context window | - | | Weight precision | - | | Features | video\_editing, editing, styles, motion\_control, audio\_out | | Native inference | No | | New | No | | Supported endpoints | `POST /v1/videos/generations` | | Alternate model ids | `pixverse/edit` | ## Pricing | Charge | Spec | Rate | | ------------------- | ---------- | ---------- | | Modify 360p | per second | \$0.085333 | | Modify 540p | per second | \$0.106667 | | Modify 720p | per second | \$0.128 | | Restyle | per second | \$0.106667 | | Motion control 360p | per second | \$0.096 | | Motion control 540p | per second | \$0.106667 | | Motion control 720p | per second | \$0.128 | | Swap 360p | per second | \$0.096 | | Swap 540p | per second | \$0.096 | | Swap 720p | per second | \$0.128 | | Upscale | per second | \$0.053333 | | Sound effects | per second | \$0.021333 | ## Example request ```bash curl https://api.empiriolabs.ai/v1/videos/generations \ -H 'Authorization: Bearer $EMPIRIOLABS_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"model": "pixverse-edit", "prompt": "sunrise over the ocean", "duration": 6}' ``` ## Parameters | Parameter | Type | Required | Default | Description | | ----------------------- | ------- | -------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `mode` | enum | no | `"modify"` | Which transformation to run. modify edits content from a prompt. restyle changes the visual style. swap replaces a subject with an uploaded image. mimic transfers the motion onto a subject image. upscale raises the resolution. sound\_effect generates a synchronized sound bed. · Allowed: `modify`, `restyle`, `swap`, `mimic`, `upscale`, `sound_effect` | | `prompt` | string | no | - | Used by modify as the edit to make, by restyle as the target style, and by sound\_effect as the sound to generate. Leave it empty on sound\_effect to derive the sound from the video. | | `resolution` | enum | no | `"540p"` | Output resolution for modify, mimic and swap. Restyle, upscale and sound\_effect follow the source clip. · Allowed: `360p`, `540p`, `720p` | | `restyle_id` | number | no | - | Optional preset id for restyle, as an alternative to a style prompt. | | `swap_target` | string | no | - | Name of the detected subject to replace in swap mode, for example person or dog. Defaults to the first subject found in the keyframe. | | `keyframe_id` | number | no | `1` | Which frame of the source video swap mode reads its subjects from. Defaults to the first frame. · Min: 1 | | `original_sound_switch` | boolean | no | false | Keep the source clip audio underneath a generated sound effect. | | `seed` | number | no | - | Reproducibility seed for restyle. · Range: 0 – 2147483647 | | `video` | string | no | - | Source video URL. Required for every mode. | | `image` | string | no | - | Replacement image for swap, subject image for mimic, or up to 3 guidance images for modify. | ## Notes Six transformations that take an existing video and return a new one, selected with `mode`. **Modes** * `modify`: edit the content of a clip from a text prompt, optionally guided by up to 3 reference images. * `restyle`: change the visual style while preserving motion and composition. Pass a `restyle_prompt` or a `restyle_id`. * `swap`: replace a subject in the clip with an uploaded image. The model detects the subjects in the chosen keyframe; use `swap_target` to name which one, otherwise the first detected subject is used. * `mimic`: transfer the motion of the source video onto a subject image. * `upscale`: raise the resolution of the clip. * `sound_effect`: generate a synchronized sound bed. Leave the prompt empty to have it derived from the video, and set `original_sound_switch` to keep the existing audio. **Output** * `modify`, `mimic` and `swap` output 360p, 540p or 720p. `restyle`, `upscale` and `sound_effect` follow the source clip. **Billing** * Billed per second of the source video at the rate for the mode and resolution. `swap` also includes a small one-off subject-detection charge, which is folded into the billed seconds for that request. **Input limits** * Video: MP4, MOV or WebM, up to 1920px on the long edge and 30 seconds. Up to 100MB for modify, mimic, swap and upscale, and 50MB for restyle and sound effects. Swap requires H.264 or H.265. * Images: PNG, JPEG or WebP, up to 20MB and 10000px on the long edge. --- *Machine-readable schema:* `GET https://api.empiriolabs.ai/v1/models/pixverse-edit`. > Six video transformations in one model: prompt editing, restyling, subject swap, motion transfer, upscaling, and generated sound effects.