Generate video
generate_videoGenerate a video clip for the title. Duration is the main cost driver, and some models bill a minimum length even when the clip is shorter — estimate first. ASYNC: returns a job with an id and status — poll get_video for the result.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tier | No | Quality/price tier, e.g. image-cheap or video-premium. Call list_ai_tiers for the current list. Omit it to use this title's default tier. | |
| model | No | Model name, if you insist on a specific one (optional). ⚠ Setting it cancels the tier COMPLETELY — together with its provider and its settings — so params may stop applying. Prefer `tier`. | |
| params | No | Model settings, as declared by the vendor for the chosen tier — for example {"aspect_ratio":"16:9","resolution":"720p","duration":"4"}. Call list_ai_tiers to see which keys this tier accepts, their allowed values and defaults. Values are strings. Unknown keys are ignored rather than rejected. | |
| prompt | Yes | What to generate. | |
| provider | No | Provider key, if you insist on one (optional). Cancels the tier the same way. | |
| title_id | No | Which game this is for — a label for the report, optional. Credits are always the publisher's, so leaving it out is normal for assets that belong to no game. |