Conception de voix

Deprecated

Crée une voix à partir d’un prompt textuel.

En-têtes

xi-api-keystringOptionnel

Paramètres de requête

output_formatenumOptionnel

Le format de sortie de l’audio généré.

Requête

This endpoint expects an object.
voice_descriptionstringRequis20-1000 characters

Description à utiliser pour la voix créée.

textstring or nullOptionnel100-1000 characters

Texte à générer, dont la longueur doit être comprise entre 100 et 1 000 caractères.

auto_generate_textbooleanOptionnelPar défaut false

Indique s’il faut générer automatiquement un texte adapté à la description de la voix.

loudnessdoubleOptionnel-1-1Par défaut 0.5

Contrôle le niveau de volume de la voix générée. -1 correspond au niveau le plus faible, 1 au niveau le plus élevé et 0 correspond approximativement à -24 LUFS.

qualitydoubleOptionnel-1-1Par défaut 0.9

Une qualité supérieure améliore le rendu vocal, mais réduit la variété.

seedinteger or nullOptionnel0-2147483647

Nombre aléatoire qui contrôle la génération de voix. La même graine avec les mêmes entrées produit la même voix.

guidance_scaledoubleOptionnel0-100Par défaut 5

Contrôle dans quelle mesure l’IA suit fidèlement le prompt. Des valeurs faibles donnent à l’IA davantage de liberté créative, tandis que des valeurs élevées l’obligent à suivre plus strictement le prompt. Des valeurs élevées peuvent donner à la voix un son artificiel ou robotique. Nous recommandons d’utiliser des prompts plus longs et détaillés avec une Guidance Scale plus faible.

should_enhancebooleanOptionnelPar défaut false

Indique s’il faut enrichir la description de la voix à l’aide de l’IA afin d’ajouter des détails et d’améliorer la qualité de génération vocale. Lorsqu’il est activé, le système développe automatiquement les prompts simples en descriptions de voix plus détaillées. La valeur par défaut est False.

Réponse

Réponse réussie

previewslist of objects

Les aperçus des voix générées.

textstring

Le texte utilisé pour prévisualiser les voix.

Erreurs

409
Conflict Error
422
Unprocessable Entity Error