Tools · Media

video_generate

Can wait for approval

Generate 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 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

NameTypeDescription
prompt*stringWhat to film — subject, motion, camera, style.
durationintegerClip length in seconds (1–30).
aspect_ratiostringLandscape, portrait, or square.16:99:161:1
providerstringBackend name (optional; auto-selected).

* required

Look at images, and make images, speech and video.