Skip to main content
POST
Video Editing
Use a Darwin API key with tools:execute. Send the source video, one to three product images, and specific editing instructions. Source and output videos are limited to 45 seconds. Keep the same Idempotency-Key when retrying the exact request. See the Video Editing guide for preparing assets 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
productImages
string<uri>[]
required

One to three JPG, PNG, or WebP images of the same product.

Required array length: 1 - 3 elements
Maximum string length: 2048

Response

Generated video.

video
object
required
Last modified on October 19, 2026