Generate a video
generate_videoMakes a video from an image the user owns. MOST EXPENSIVE: per second, charged on completion, purchased credits only. Async: poll get_task. Quote with dry_run:true (free), confirm with the user. Pick by job (credits/s, std/pro):
Still to life: kling-v3. 120/160; sound +40; 4K 600; 3-15s; end_frame_id.
Cheapest with sound: veo-3.1-lite-generate-preview. 4/6/8s; 8s = 280 (1080p 440); end_frame_id.
Keep a clip's acting, new person or scene: kling-v3-omni + reference_video_id (180/240, silent) + 3 reference_image_ids (6 with no clip).
Same at 120/160 when 10s, 1080p, silent do: kling-video-o1 + the clip.
Copy a dance onto the still's person: kling-motion-control. 180/240 per second of the clip (3-30s), silent.
Edit a clip by describing it: gemini-omni-1.1-flash. 140 at 720p (1080p 290, 4K 430, upscales); 3-10s set by the model; 3 reference_image_ids.
Long takes, dialogue, many refs: dreamina-seedance-2-5-260628. 150/330/820 (lite/std/pro), 4-30s, sound. No generation_id: follows reference_image_ids / reference_video_ids (billed as input) or text alone, in aspect_ratio. clip_task + reference_video_id edits/extends it. draft:true = 480p; finalize_draft_id renders it 1080p. whoami: default + models off. @slug or entity_ids attach entities.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Default std 720p; pro 1080p; lite 480p; 4k per guide. | |
| name | No | Library title. | |
| audio | No | Kling 3.0/Omni only, never with a reference clip. | |
| draft | No | ||
| model | No | Default: whoami's. | |
| prompt | No | The motion; for an edit, the change. | |
| dry_run | No | Quote only (exact credits), free. | |
| duration | No | Whole seconds within the model's range. Default 5 (Veo 8); Motion Control uses the clip's. | |
| clip_task | No | ||
| entity_ids | No | ||
| keep_sound | No | Edit: false = new sound | |
| project_id | Yes | ||
| aspect_ratio | No | ||
| end_frame_id | No | Image the clip lands on. | |
| generation_id | No | First-frame image id (Seedance: optional). | |
| extend_direction | No | ||
| finalize_draft_id | No | Draft video id; alone. | |
| reference_video_id | No | Finished video id: acting to keep, movement to copy, or clip to edit. | |
| reference_image_ids | No | Stills to stay faithful to; per-model counts above. | |
| reference_video_ids | No | Seedance: clips to follow, max 30s. | |
| character_orientation | No | Motion Control: whose face, the still's or the clip's. Default video. |