Create a storyboard
create_storyboardMake a film three ways: from a brief you have written as scenes, from media the account already holds, or from a video you have already analysed. Scenes are written in order and chained in one write, so a twelve-beat board arrives as one video path rather than twelve calls. Anything you leave out of a scene is filled in: the description and the image prompt fall back to the title, and an unwritten motion prompt gets a subtle drift. Cast members are named, not referenced — the names of Subjects the account holds, which list_subjects finds. settings applies to written scenes and from_analysis; a film made from_media takes its frame from the first file, so set its settings with edit_storyboard afterwards. A style is looked up before anything is made, and a name that misses makes nothing. Nothing here spends credits. For written scenes, attach owned footage with edit_storyboard's set_scene_clip, or use generate_scene_images when new stills are needed. Add a voice-over or music with edit_storyboard's add_sound before rendering.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cast | No | ||
| name | No | ||
| scenes | No | ||
| settings | No | ||
| from_media | No | ||
| from_analysis | No | Build the board from a video you read with get_video_analysis_bundle and wrote a beat sheet for with save_video_analysis. One scene per beat, with its title, its intent, its prompts and its MEASURED length — never re-type a beat sheet as scenes, because the arithmetic is ours and a board written by hand remembers no source, which is what match_scene_motion needs. The prompts arrive written for a different subject, as the beat sheet wrote them: transpose them in one edit_storyboard afterwards. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cast | Yes | ||
| brief | Yes | ||
| notes | Yes | ||
| quote | No | ||
| texts | Yes | ||
| scenes | Yes | ||
| sounds | Yes | ||
| videos | Yes | ||
| credits | Yes | ||
| history | Yes | ||
| message | Yes | ||
| skipped | No | ||
| started | No | ||
| stopped | No | ||
| accepted | No | ||
| receipts | No | ||
| schedule | Yes | ||
| settings | Yes | ||
| reference | No | ||
| storyboard | Yes | ||
| download_url | No | ||
| generation_id | No | ||
| remaining_scenes | No |