Run a workflow
Start a workflow run, watch it finish, and download the audio — in Python or the CLI.
A run executes a workflow’s pipeline and produces audio. Start a run, poll until it’s done, then download the result.
Start and watch a run
There are no completion webhooks yet — polling is the way. Short scripts finish in seconds.
Download the result
A completed run’s export is a ZIP of the audio files plus a manifest.csv. The download URL is pre-signed and valid for 15 minutes.
Only completed runs are downloadable — active, failed, or cancelled runs return 409, and a run with no audio returns 404.
List workflows and run history
Related
- Use your own script — run with per-request text
- Use templates — create a workflow from a template
- Workflow — what’s inside a workflow

