Hoppa till navigering

Skapa podcast

Skapa och autokonvertera ett podcastprojekt. För närvarande står vi för LLM-kostnaden, men du debiteras fortfarande för ljudgenereringen. I framtiden kommer du att debiteras för både LLM- och ljudgenereringskostnaderna.

Headers

xi-api-keystringValfri
safety-identifierstring or nullValfri

Används för moderering. Din arbetsyta måste vara godkänd för att använda den här funktionen.

Förfrågan

This endpoint expects an object.
model_idstringObligatorisk

ID:t för modellen som ska användas för detta Studio-projekt. Du kan anropa GET /v1/models för att lista alla tillgängliga modeller.

modeobjectObligatorisk

Typen av podcast som ska genereras. Kan vara 'conversation', en interaktion mellan två röster, eller 'bulletin', en monolog.

sourceobject or list of objectsObligatorisk

Källinnehållet för podcasten.

quality_presetenum or nullValfri

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. 'ultra' - ultra quality output format, 192kbps with 44.1kHz sample rate and highest improvements on our side. 'ultra_lossless' - ultra quality output format, 705.6kbps with 44.1kHz sample rate and highest improvements on our side in a fully lossless format. If not provided, defaults to the highest quality preset available on your subscription tier.

Tillåtna värden:
duration_scaleenumValfriStandard är default

Längd på den genererade podcasten. Måste vara ett av följande: short – ger podcaster kortare än 3 minuter. default – ger podcaster på ungefär 3–7 minuter. long – ger podcaster längre än 7 minuter.

Tillåtna värden:
languagestring or nullValfri=2 characters

Ett valfritt språk för Studio-projektet. Språkkod med två bokstäver (ISO 639-1).

introstring or nullValfri<=1500 characters

Introduktionstexten som alltid läggs till i början av podcasten.

outrostring or nullValfri<=1500 characters

Avslutningstexten som alltid läggs till i slutet av podcasten.

instructions_promptstring or nullValfri<=3000 characters

Ytterligare instruktionsprompt för podcastgenereringen som används för att justera podcastens stil och ton.

highlightslist of strings or nullValfri

En kort sammanfattning av eller höjdpunkter från Studio-projektets innehåll, med viktiga punkter eller teman. Den ska vara mellan 10 och 70 tecken.

callback_urlstring or nullValfri

En URL som vår tjänst anropar när Studio-projektet har konverterats. Begäran innehåller ett JSON-objekt med konverteringens status. Meddelanden:

  1. När projektet har konverterats: { 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. När projektkonverteringen misslyckades: { 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. När kapitlet har konverterats: { 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. När kapitelkonverteringen misslyckades: { 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" } }

apply_text_normalizationenum or nullValfri

Den här parametern styr textnormalisering med fyra lägen: 'auto', 'on', 'apply_english' och 'off'. När den är inställd på 'auto' avgör systemet automatiskt om textnormalisering ska tillämpas (t.ex. att skriva ut tal). Med 'on' tillämpas textnormalisering alltid, medan den hoppas över med 'off'. 'apply_english' är samma som 'on', men förutsätter att texten är på engelska.

Tillåtna värden:

Svar

Lyckat svar
projectobject

Projektet som är kopplat till den skapade podcasten.

Fel

422
Unprocessable Entity Error