Skip to main content
POST
Video Replication
Use a Darwin API key with tools:execute. Send a source video, one to three character images, written instructions, and an optional authorized voice sample. Source and output videos are limited to 45 seconds. Keep the same Idempotency-Key when retrying the exact request. See the Video Replication guide for preparing a character variant and reviewing the result.

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 October 19, 2026