flow_generate_video
Prepare Veo video drafts from prompts, shots, or ingredients without spending credits; verify and optionally click Generate for paid rendering with chosen duration, ratio, quality, and references.
Instructions
Prepare a Veo video (prepare-only, no spend). Fast tests, Quality finals; ingredients need 8s.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Video model name — call flow_list_models for the live list — or auto. | auto |
| ratio | No | 16:9 or 9:16. | 16:9 |
| shots | No | Multi-shot plan, max 6: [{prompt, duration}]. | |
| style | No | Look/mood/lighting. No extra subjects in refs. | |
| camera | No | Camera move: push-in, pull-back, pan, tilt, orbit, tracking shot. | |
| prompt | Yes | Scene + action. Optics stay in UI selectors. | |
| quality | No | Resolution 360p/720p. | |
| campaign | No | Campaign id (doubles as project name when name absent). | |
| duration | No | 4s, 6s, 8s, 10s. Ingredients force 8s. | 4s |
| quantity | No | Variants 1-4 for compare-pick-refine. | |
| end_frame | No | Last-frame image path. Shares light/framing with start. | |
| use_scene | No | Name of a single project scene to reference via "@name" (added in addition to ingredients). | |
| hero_frame | No | Alias for start_frame. | |
| ingredients | No | Project images/characters to reference via "@name" (e.g., ["Bob the Astronaut", "Image 3"]). Discover names via flow_list_mention_options. | |
| project_url | No | Direct Flow /project/ URL — wins over name matching. | |
| start_frame | No | First-frame image path (hero frame anchor). | |
| anchor_frame | No | Prior strongest frame carried for continuity. | |
| auto_confirm | No | Always prepare-only today. Reserved. | |
| project_name | No | Project name (remembered; reopens instead of duplicating). | |
| use_character | No | Name of a single project character to reference via "@name" (added in addition to ingredients). | |
| confirm_generate | No | LIVE PAID CLICK: verify, click Generate (credits), poll video. Default false. | |
| reference_images | No | Paths to local reference images to upload (optional). |