Generate voiceover
generate_voiceoverGenerate TTS audio for the project's voice blocks. Without voice_block_ids it fills gaps: only blocks with no audio yet run, so re-calling it is always safe (already-generated and currently-generating blocks are skipped, never re-billed). Pass voice_block_ids to explicitly REgenerate those blocks (e.g. after changing a block's voice). Speakers must have voices bound first — set_narrator_voice / set_character_voice. Optional editable_sections/settings apply to every selected block (see get_section_template("voice_block") and list_models("voice_block")). On a project that already has a storyboard, segment timings are re-aligned to the new audio automatically when the run finishes (prompts and rendered images untouched) — await_jobs until the project is idle before exporting. Async — returns one job per block.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | TTS model ID; empty uses the default for the project's TTS provider. If set, it must belong to that provider — see list_models("voice_block") for each model's provider | |
| settings | No | Model-specific TTS settings applied to every selected block; valid keys come from the model's settings_schema in list_models("voice_block") | |
| project_id | Yes | Project ID, as returned by create_project or list_projects | |
| voice_block_ids | No | Block IDs (from list_voice_blocks) to explicitly REgenerate; omit to fill gaps — only blocks with no audio yet run | |
| editable_sections | No | Per-call prompt section overrides applied to every selected block; see get_section_template("voice_block") |