Créer un podcast

Crée et convertit automatiquement un projet de podcast. Actuellement, nous prenons en charge le coût du LLM, mais la génération audio vous sera tout de même facturée. À l’avenir, les coûts du LLM et de la génération audio vous seront facturés.

En-têtes

xi-api-keystringOptionnel
safety-identifierstring or nullOptionnel

Utilisé pour la modération. Votre Workspace doit être autorisé pour utiliser cette fonctionnalité.

Requête

This endpoint expects an object.
model_idstringRequis

L’ID du modèle à utiliser pour ce projet Studio. Vous pouvez interroger GET /v1/models pour répertorier tous les modèles disponibles.

modeobjectRequis

Le type de podcast à générer. Peut être « conversation », une interaction entre deux voix, ou « bulletin », un monologue.

sourceobject or list of objectsRequis
Le contenu source du podcast.
quality_presetenum or nullOptionnel

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.

Valeurs autorisées:
duration_scaleenumOptionnelPar défaut default

Durée du podcast généré. Doit être l’une des suivantes : short - produit des podcasts de moins de 3 minutes. default - produit des podcasts d’environ 3 à 7 minutes. long - produit des podcasts de plus de 7 minutes.

Valeurs autorisées:
languagestring or nullOptionnel=2 characters

Une langue facultative du projet Studio. Code de langue à deux lettres (ISO 639-1).

introstring or nullOptionnel<=1500 characters

Le texte d’introduction qui sera toujours ajouté au début du podcast.

outrostring or nullOptionnel<=1500 characters

Le texte de conclusion qui sera toujours ajouté à la fin du podcast.

instructions_promptstring or nullOptionnel<=3000 characters

Prompt d’instructions supplémentaires pour la génération du podcast, utilisé pour ajuster son style et son ton.

highlightslist of strings or nullOptionnel

Bref résumé ou points forts du contenu du projet Studio, présentant les idées ou thèmes principaux. Doit comporter entre 10 et 70 caractères.

callback_urlstring or nullOptionnel

Une URL qui sera appelée par notre service lorsque le projet Studio sera converti. La requête contiendra un objet JSON indiquant l’état de la conversion. Messages :

  1. Lorsque le projet a été converti avec succès : { 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. Lorsque la conversion du projet a échoué : { type: “project_conversion_status”, event_timestamp: 1234567890, data: { request_id: “1234567890”, project_id: “21m00Tcm4TlvDq8ikWAM”, conversion_status: “error”, project_snapshot_id: None, error_details: “Détails de l’erreur si la conversion a échoué” } }

  3. Lorsque le chapitre a été converti avec succès : { 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. Lorsque la conversion du chapitre a échoué : { 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: “Détails de l’erreur si la conversion a échoué” } }

apply_text_normalizationenum or nullOptionnel

Ce paramètre contrôle la normalisation du texte selon quatre modes : « auto », « on », « apply_english » et « off ». Lorsqu’il est défini sur « auto », le système décide automatiquement d’appliquer ou non la normalisation du texte (par exemple, en écrivant les nombres en toutes lettres). Avec « on », la normalisation du texte est toujours appliquée, tandis qu’avec « off », elle est ignorée. « apply_english » est identique à « on », mais suppose que le texte est en anglais.

Valeurs autorisées:

Réponse

Réponse réussie

projectobject

Le projet associé au podcast créé.

Erreurs

422
Unprocessable Entity Error