Vai alla navigazione

Crea podcast

Crea e converti automaticamente un progetto podcast. Al momento copriamo noi il costo dell’LLM, ma ti verrà comunque addebitata la generazione audio. In futuro ti verranno addebitati sia i costi dell’LLM sia quelli della generazione audio.

Header

xi-api-keystringOpzionale
safety-identifierstring or nullOpzionale

Usato per la moderazione. Per usare questa funzionalità, il tuo workspace deve essere incluso nella allowlist.

Richiesta

This endpoint expects an object.
model_idstringObbligatorio

L'ID del modello da usare per questo progetto Studio. Puoi eseguire una query GET /v1/models per elencare tutti i modelli disponibili.

modeobjectObbligatorio

Il tipo di podcast da generare. Può essere 'conversation', un'interazione tra due voci, oppure 'bulletin', un monologo.

sourceobject or list of objectsObbligatorio
Il contenuto sorgente per il podcast.
quality_presetenum or nullOpzionale

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.

Valori consentiti:
duration_scaleenumOpzionalePredefinito a default

Durata del podcast generato. Deve essere una delle seguenti: short - produce podcast di durata inferiore a 3 minuti. default - produce podcast di durata approssimativamente compresa tra 3 e 7 minuti. long - produce podcast di durata superiore a 7 minuti.

Valori consentiti:
languagestring or nullOpzionale=2 characters

Una lingua facoltativa del progetto Studio. Codice lingua di due lettere (ISO 639-1).

introstring or nullOpzionale<=1500 characters

Il testo introduttivo che verrà sempre aggiunto all'inizio del podcast.

outrostring or nullOpzionale<=1500 characters

Il testo finale che verrà sempre aggiunto alla fine del podcast.

instructions_promptstring or nullOpzionale<=3000 characters
Prompt con istruzioni aggiuntive per la generazione del podcast, usato per modificarne stile e tono.
highlightslist of strings or nullOpzionale
Un breve riepilogo o i punti salienti del contenuto del progetto Studio, con punti o temi chiave. Deve contenere da 10 a 70 caratteri.
callback_urlstring or nullOpzionale

Un URL che verrà chiamato dal nostro servizio quando il progetto Studio viene convertito. La richiesta conterrà un blob JSON con lo stato della conversione. Messaggi:

  1. Quando il progetto è stato convertito correttamente: { 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. Quando la conversione del progetto non è riuscita: { type: "project_conversion_status", event_timestamp: 1234567890, data: { request_id: "1234567890", project_id: "21m00Tcm4TlvDq8ikWAM", conversion_status: "error", project_snapshot_id: None, error_details: "Dettagli dell'errore se la conversione non è riuscita" } }

  3. Quando il capitolo è stato convertito correttamente: { 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. Quando la conversione del capitolo non è riuscita: { 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: "Dettagli dell'errore se la conversione non è riuscita" } }

apply_text_normalizationenum or nullOpzionale

Questo parametro controlla la normalizzazione del testo con quattro modalità: 'auto', 'on', 'apply_english' e 'off'. Se impostato su 'auto', il sistema deciderà automaticamente se applicare la normalizzazione del testo (ad esempio, scrivendo i numeri in lettere). Con 'on', la normalizzazione del testo verrà sempre applicata, mentre con 'off' verrà ignorata. 'apply_english' equivale a 'on', ma presume che il testo sia in inglese.

Valori consentiti:

Risposta

Risposta riuscita
projectobject
Il progetto associato al podcast creato.

Errori

422
Unprocessable Entity Error