How it works
Call list_models first to see each video model's lengths, resolutions and ratios. generate_video returns a job_id right away; poll get_job until it is COMPLETED for the result_url. Credits come from your credit pool and are refunded automatically if the render fails.
Inputs
Name
Type
Required
Description
prompt
string
required
What happens in the video.
model
string
optional
A model from list_models.
start_image_url
string
optional
Image to start from (image-to-video).
duration
number
optional
Seconds, as the model allows.
aspect_ratio
string
optional
e.g. '9:16' for Reels and Stories.
element_ids
string[]
optional
Saved characters or props from create_element.
Returns
{ job_id, status: 'IN_QUEUE', creditsReserved, note }Examples
Animate a static ad for Reels
The agent takes the winning 9:16 image and turns it into a 5-second video.
{
"prompt": "Slow push-in on the car, headlights flick on",
"start_image_url": "<imageUrl>",
"aspect_ratio": "9:16",
"duration": 5
}Related tools
list_modelsList video models
Every video model with what it supports: lengths, resolutions, ratios and sound.
get_jobCheck a video, voice or upscale job
Poll a background job until it is done and get the result link.
get_balanceCheck your credit balance
Your remaining credits for video, voice, dub, lip-sync and upscale.