Skip to main content
POST
Video Replication
Authenticate with a Darwin API key carrying tools:execute. Supply an Idempotency-Key of 1 to 200 characters, and reuse it only when retrying the exact same request. Keys without access return 403 API_UNAVAILABLE before request validation. See the Video Replication guide for the defined media inputs.

Authorizations

x-api-key
string
header
required

Headers

Idempotency-Key
string
required

Reuse the same key only for an identical request.

Required string length: 1 - 200

Body

application/json
videoUrl
string<uri>
required

Source MP4 or MOV video, up to 45 seconds.

Maximum string length: 2048
instructions
string
required

Describe the requested changes and what should stay consistent.

Required string length: 1 - 4000
characterImages
string<uri>[]
required

One to three reference images of the same new character.

Required array length: 1 - 3 elements
Maximum string length: 2048
voiceUrl
string<uri>

Optional MP3 or WAV sample of the new character’s authorized voice.

Maximum string length: 2048

Response

Generated video.

video
object
required
Last modified on November 2, 2026