Video Editing

The video editing endpoints take an existing video and return an enhanced one. They live on dedicated routes alongside video generation, with their own request shape and pricing.

Endpoint	Description
`POST /v2/videos/upscale`	Upscale and frame-interpolate footage with Topaz.
`POST /v2/videos/edit`	Restyle, replace, or transform clips with a prompt (Wan 2.7 VideoEdit).

These endpoints behave like generation — they return immediately with a jobId, deduct credits at submission, emit the same webhook events, and refund on failure.

Common request fields

Field	Type	Required	Description
`model`	string	Yes	The model identifier (see per-endpoint pages).
`webhookUrl`	string	No	URL to receive webhook notifications.
`webhookEvents`	string[]	No	Events to subscribe to: `"progress"`, `"completed"`, `"failed"`.
`prompt`	string	Edit only	Text prompt describing the desired edit (required for `/v2/videos/edit`).
`<modelParams>`	object	Yes	Per-model params object — name varies (`topazVideoParams`, `wan27VideoeditParams`).

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 endpoints

Upscale (`POST /v2/videos/upscale`)

Model	Identifier	Description
Topaz Video Upscale	`"topaz-video-upscale"`	Pro-grade video upscale and frame interpolation, up to 4K.

Edit (`POST /v2/videos/edit`)

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.