Generate Long-Form Narration
generate_long_formGenerate long-form narration (up to 500,000 characters ≈ 9 hours of audio) as an async job. Requires a Pro subscription key. Kokoro narration voices only — Arabic (ar_*) and cloned (voice_*) voices are rejected by the Long-Form engine. Returns a job id — poll get_job_status; parts render progressively and audio_url appears when completed.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tone | No | Tone preset. | neutral |
| input | Yes | The full script, up to 500,000 characters. | |
| pitch | No | Pitch shift in semitones (-4 to 4). | |
| speed | No | ||
| voice | No | Kokoro voice id — call list_voices for the catalog. | af_aoede |
| format | No | mp3 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | ||
| status | Yes | ||
| input_chars | Yes |