ADMINISTRATIONStudio

Create Podcast

Create and auto-convert a podcast project. Currently, the LLM cost is covered by us but you will still be charged for the audio generation. In the future, you will be charged for both the LLM and audio generation costs.

Headers

xi-api-keystringRequired

Request

This endpoint expects an object.
model_idstringRequired

The ID of the model to be used for this Studio project, you can query GET /v1/models to list all available models.

modeobjectRequired
The type of podcast to generate. Can be 'conversation', an interaction between two voices, or 'bulletin', a monologue.
sourceobject or list of objectsRequired
The source content for the Podcast.
quality_presetenumOptionalDefaults to standard

Output quality of the generated audio. Must be one of: standard - standard output format, 128kbps with 44.1kHz sample rate. high - high quality output format, 192kbps with 44.1kHz sample rate and major improvements on our side. Using this setting increases the credit cost by 20%. ultra - ultra quality output format, 192kbps with 44.1kHz sample rate and highest improvements on our side. Using this setting increases the credit cost by 50%. ultra lossless - ultra quality output format, 705.6kbps with 44.1kHz sample rate and highest improvements on our side in a fully lossless format. Using this setting increases the credit cost by 100%.

Allowed values:
duration_scaleenumOptionalDefaults to default

Duration of the generated podcast. Must be one of: short - produces podcasts shorter than 3 minutes. default - produces podcasts roughly between 3-7 minutes. long - prodces podcasts longer than 7 minutes.

Allowed values:
languagestringOptional=2 characters

An optional language of the Studio project. Two-letter language code (ISO 639-1).

highlightslist of stringsOptional
A brief summary or highlights of the Studio project's content, providing key points or themes. This should be between 10 and 70 characters.
callback_urlstringOptional

A url that will be called by our service when the Studio project is converted. Request will contain a json blob containing the status of the conversion Messages:

  1. When project was converted successfully: { type: “project_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, conversion_status: “success”, project_snapshot_id: “22m00Tcm4TlvDq8ikMAT”, error_details: None, } }

  2. When project conversion failed: { type: “project_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, conversion_status: “error”, project_snapshot_id: None, error_details: “Error details if conversion failed” } }

  3. When chapter was converted successfully: { type: “chapter_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, chapter_id: “22m00Tcm4TlvDq8ikMAT”, conversion_status: “success”, chapter_snapshot_id: “23m00Tcm4TlvDq8ikMAV”, error_details: None, } }

  4. When chapter conversion failed: { type: “chapter_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, chapter_id: “22m00Tcm4TlvDq8ikMAT”, conversion_status: “error”, chapter_snapshot_id: None, error_details: “Error details if conversion failed” } }

Response

Successful Response
projectobject
The project associated with the created podcast.

Errors