Plan an Approved Video Script
video_storyboard_createCreate a vertical video storyboard for the user-approved script in an existing project. Spends planning credits; returns scene narration, factual review notes, references and the production credit estimate. Does not generate images or animate video. Existing account access applies.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>",
"script": "<script>",
"workspaceId": "<workspaceId>",
"idempotencyKey": "<idempotencyKey>",
"confirmScriptApproved": "<confirmScriptApproved>"
},
"name": "video_storyboard_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| genre | No | Genre pack id. GET /generation-options/faceless lists them in genres, with what each format needs in formats. | |
| script | Yes | ||
| voice_id | No | ||
| projectId | Yes | UUID string. | |
| series_id | No | ||
| multi_shot | No | Let one video generation cover several timed shots and camera angles. Adjacent script blocks are grouped into takes. | |
| storyboard | No | Generate one approved storyboard sheet instead of per-scene keyframes and use it as the video reference. Implies multi_shot. | |
| video_model | No | ||
| workspaceId | Yes | ||
| clip_seconds | No | Target length of each multi-shot generation. Defaults to 15, or the model maximum when lower. | |
| story_kit_id | No | ||
| visual_style | No | ||
| character_ids | No | ||
| idempotencyKey | Yes | ||
| image_model_id | No | ||
| caption_style_id | No | ||
| include_captions | No | ||
| planner_model_id | No | ||
| confirmScriptApproved | Yes | ||
| generate_sound_effects | No | ||
| target_duration_seconds | No | ||
| use_seamless_transitions | No | Chain each scene's clip into the next with end frames. Applies only to video models that support end frames. | |
| generate_background_music | No | ||
| style_reference_asset_ids | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |