MCP/Tools/Video/generate_video
generate_video

Generate a video ad

High cost

Make a short video from a prompt and an optional start image. Runs in the background.

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
}