Video Editing
Restyle, replace, or transform existing clips with a prompt.
The video editing endpoint takes an existing video and a text prompt, and returns a transformed clip — outfit swaps, background replacement, restyling (film grain, animation, color regrade), and other prompt-driven edits, while preserving subject identity and motion.
It lives on a dedicated route alongside video generation, with its own request shape and pricing.
| Endpoint | Description |
|---|---|
POST /v2/videos/edit | Restyle, replace, or transform clips with a prompt (Wan 2.7 VideoEdit). |
Looking to increase resolution or frame rate without changing the content? That's Video Upscale (POST /v2/videos/upscale), a separate endpoint — not this one.
Like generation, this endpoint returns immediately with a jobId, deducts credits at submission, emits the same webhook events, and refunds on failure.
Request fields
| Field | Type | Required | Description |
|---|---|---|---|
model | string | Yes | Model identifier — "wan-2.7-videoedit". |
prompt | string | Yes | Text describing the desired edit. |
wan27VideoeditParams | object | Yes | Source video and edit settings. See Wan 2.7 VideoEdit for every field. |
webhookUrl | string | No | URL to receive webhook notifications. |
webhookEvents | string[] | No | Events to subscribe to: "progress", "completed", "failed". |
Idempotency
Include an Idempotency-Key header to prevent duplicate jobs if the same request is sent twice.
Response
Status: 202 Accepted
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "QUEUED"
}Poll GET /v2/jobs/:id — the completed job carries videoUrl on result (CDN-hosted with the standard 90-day retention).
Available models
| Model | Identifier | Description |
|---|---|---|
| Wan 2.7 VideoEdit | "wan-2.7-videoedit" | Prompt-driven restyle, outfit swap, background replacement on existing clips. |
Error responses
| Status | Error | Meaning |
|---|---|---|
400 | Validation error | Invalid parameters — check details. |
401 | Unauthorized | Missing or invalid API key. |
402 | Insufficient credits | Not enough credits to run this model. |
503 | Service unavailable | Job queue is temporarily down. |