Make a video clip
generate_videoMake a short clip from words — with its own sound and spoken lines (write the dialogue in quotes) — optionally starting from a picture or keeping people and things looking like reference pictures, with Tesseract (charged to the signed-in account). Default gemini-omni-1.2-flash (3–15 s, up to 6 reference pictures). Returns a job_id; video takes minutes — call check_job every 10–20 seconds.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>"
},
"name": "generate_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | A video model from list_models. | |
| params | No | The model's own fields (fal.ai's names), e.g. {"aspect_ratio": "16:9", "seed": 7}. A field the model's price does not cover is refused, never sent. | |
| prompt | Yes | What happens, and how it is filmed. | |
| max_usd | No | The most this may cost, in US dollars: a dearer job is not started. | |
| rights_ok | No | With a source video of someone else's: true only when the person says the video and its sound belong to their makers, and the result is for their own use unless they hold the rights. | |
| first_frame | No | A picture: a public https:// URL, or a data:image/…;base64,… URI (up to 10 MB). | |
| aspect_ratio | No | e.g. "16:9", "9:16". | |
| duration_sec | No | Its length; each model makes its own set of lengths. | |
| likeness_consent | No | Only when the person asked for it themselves, about who is shown: "self" (them), "consented" (an adult who agreed to it) or "made-up" (a made-up person) — and only when nobody shown is under 18 or a public figure, and there is no nudity or sexual content. Needed by the effects that put a person in, talking or lip-synced people, headshots and try-ons. | |
| reference_images | No | Gemini Omni: pictures of who or what must look the same in the clip (a character's face, a product) — not frames; up to 6 on gemini-omni-1.2-flash. |