Sign in
AI Generation

Generate an AI Video

Generate a short clip from a prompt, animate an image, or make a photo speak. Billed in AI credits per second; returns a job to poll.

post/ai/video

Request body

promptstring

What to generate. Optional when you only animate an image or make it speak.

imageRefstring

Reference image: the first frame to animate, or the portrait for speech. An https URL, a data URI, a brand asset reference like brand:image:123, or a gen:// reference.

lastImageRefstring

Reference image for the last frame of a transition.

scriptstring

Text the person should say. Runs through text to speech first (1 AI credit per 10 seconds).

voicestring

Voice id for the script. See the voice catalog on the audio endpoints.

audiostring

Your own audio track instead of a script.

consentboolean

Required for speech. Confirms you may use this person's likeness.

durationnumber

Any whole number of seconds from 3 to 15, capped by your plan. Default 5. Speech follows the audio length.

presetstring

Role preset id from List AI Presets. Default cinematic-scene.

lookstring

Look preset id from List AI Presets.

aspectstring

1:1, 16:9, 9:16, 4:3 or 3:4.

fullHdboolean

1080p output at 2x credits.

freshboolean

Skip the cache and generate a new take.

syncboolean

Wait for the result instead of returning a job (up to 120 seconds).

webhook_urlstring

Called with the job when it finishes.

Response

Successful response

object required

Changes