Generate a video clip
generate_videoGenerate a video clip from a prompt with a hosted model and put it on the timeline. The clip takes its place on the timeline at start straight away, and the finished video fills it when the run ends. Quality standard (default, Kling: 5 or 10 s, 16:9 / 9:16 / 1:1, silent) or best (Veo 3.1: 4 / 6 / 8 s, 16:9 / 9:16, optional audio, costs more). model: "wan-3.0" takes any length from 2 to 30 s in one generation, 16:9 / 9:16 / 1:1 at 720p unless resolution says otherwise, with free synchronised audio; it cuts between listed scenes itself and keeps the same people across them, so a story of several scenes that fits in 30 s and starts from nothing is one Wan 3.0 run (name each recurring person once with their look, then the scenes in order) rather than a clip per scene. A 30 s take waits about twelve minutes. model: "gemini-omni-flash" is 3-8 s at 720p (1080p when resolution asks for it), 16:9 / 9:16, always with native audio, and holds a four-scene story in 8 s. image turns a project image into the first frame and routes on its own to Hailuo 02 (standard) or Kling 3 Pro (best), which animate a still faithfully; describe only the motion. ref lists stills and videos the model works from rather than starts on (a product, a place, a move to copy): name them @Image1, @Image2… and @Video1… in the prompt in the order given. model: "seedance-2.5" takes up to 9 stills and 3 videos (30 s of video in all; clip.mp4#2-8 sends seconds 2 to 8, and each second sent bills like a generated one at a lower rate); Seedance refuses any ref showing a real-looking person, so it takes no cast; MiniMax H3 and Wan 3.0 take stills only. People who must come back in another video, or in a scene you will redo on its own: write them as @Name in the prompt and describe the action, not the person. The first time a name is used, pass character: ["Name: who they are, hair, wardrobe"]; the job draws a reference sheet, keeps it in the project (the timeline header lists the cast; the sheet stills stay out of media listings) and later shots just say @Name. Cast everyone who recurs, kids included, or they change every shot. Cast shots at standard run 5-15 s on MiniMax H3 straight from the sheet stills; at best, 3-10 s on Kling 3 Pro from a drawn first frame for one person, or 2-30 s on Wan 3.0 from the sheet for two. A shot with more than one @Name goes to best on its own unless quality or model is given. motion only applies to the first-frame recipe. Open a cast shot medium or closer on one action so the face is large enough to keep; a wide, fast, many-body frame comes back with the face deformed. Returns at once with the generation id; generation_status with wait: true waits up to about half a minute at a time and fills the pending clip when the run ends. Costs credits; the error says what to fix.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Reference stills and videos (media ids or names; a video takes #from-to), @Image1/@Video1 in order | |
| name | No | Clip name; default: the prompt, shortened | |
| seed | No | ||
| wait | No | true waits for the result in this call (a long run hands back a job); default: return at once | |
| audio | No | Generate sound (best tier only) | |
| image | No | First frame: media id or file name | |
| model | No | Exact model id; overrides quality | |
| start | No | Timeline seconds; default: after the track’s last clip | |
| track | No | Track name or id; default: first video track or a new "Generated" one | |
| aspect | No | Default: the project’s, or the closest the model renders | |
| motion | No | With a cast member: the action alone for the video model; the prompt then shapes the first frame | |
| prompt | Yes | What the clip should show; be concrete about subject, motion and camera | |
| project | Yes | Project id or exact name | |
| quality | No | ||
| character | No | "Name: description" for each @Name in the prompt the project does not know yet | |
| resolution | No | Where the model offers a choice; 720p when unset. Each size bills its own rate | |
| negativePrompt | No | ||
| durationSeconds | No | Clip length; each model offers a fixed set |