Tools · Media
video_generate
Can wait for approvalGenerate a short video clip from a text description. Saves an MP4 and returns its path so a chat surface can play it. Use for b-roll, product shots, animations, concept scenes — not for editing existing footage.
When to use: Use video_generate to CREATE a short video clip from a description — a product shot, an animation, b-roll, a concept scene. Write a specific prompt (subject, motion, camera, style). Generation takes time; the call blocks until the clip is ready, then saves an MP4 and returns its path with a MEDIA: tag a chat surface can play. Keep clips short (a few seconds). It does not edit existing footage.
Example
The call
{
"tool": "video_generate",
"arguments": {
"prompt": "A 4-second loop of a progress bar filling up",
"duration": 4
}
}Needs a video API key, e.g. FAL_KEY or REPLICATE_API_TOKEN
So it isn't run here, and no output is shown: nothing on this page is made up.
Parameters
| Name | Type | Description |
|---|---|---|
| prompt* | string | What to film — subject, motion, camera, style. |
| duration | integer | Clip length in seconds (1–30). |
| aspect_ratio | string | Landscape, portrait, or square.16:99:161:1 |
| provider | string | Backend name (optional; auto-selected). |
* required
More in Media
Look at images, and make images, speech and video.