v1

latestOpenAPI 3.1.02026-07-1371123.3 KB

Podcasts

Create any audio content with an AI-generated script

Starts a background job that creates an AI generated script and produces an audio file. The response contains a job_id that can be used with the /podcast/{job_id} endpoint to query for status. Requires a valid X-API-TOKEN header.

Throws:
- 429 if the user has too many jobs in flight.
- 422 if provided voice_ids are not unique
- 400 if any voice_ids or music_ids provided are invalid

post/podcast

Request body

promptstring required

The prompt for the episode, can include links

voice_idsstring[]

A list of voice_ids to use for the generated audio. If the script has multiple speakers, we will use the voices from this list in the order then appear in. All ids in this list must be unique. If no IDs are provided, up to 2 defaults will be used.

Response

Successful Response

job_idstring uuid required

The job ID for the episode generation. The status of this job can be queried using the/podcast/{job_id} endpoint.