Utilisez l'API HTTP Voice Design pour créer, lister, consulter et supprimer des voix personnalisées.
Endpoint
- China (Beijing)
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/customizationRemplacez {WorkspaceId} par votre ID d'espace de travail réel.En-têtes de requête
Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
Authorization | string | Oui | Jeton d'autorisation au format |
Content-Type | string | Oui | Type MIME du corps de la requête. Définissez cette valeur sur |
Créer une voix
Corps de la requête | Les exemples suivants utilisent la configuration de la région China (Beijing). Remplacez {WorkspaceId} par votre identifiant réel d’espace de travail. |
modelstring(Obligatoire)Modèle de conception de voix. Valeurs valides :
| |
inputobject(Obligatoire)Objet des paramètres d'entrée.
Propriétés action string(Obligatoire)Type d'opération.
string(Obligatoire)Modèle de synthèse vocale (TTS) sous-jacent à la voix. Cette valeur doit correspondre au modèle utilisé lors de l'appel à l'API TTS. Toute incompatibilité entraîne l'échec de la synthèse.voice_prompt string(Obligatoire)Description textuelle des caractéristiques vocales souhaitées. Seuls le chinois et l'anglais sont pris en charge.
string(Obligatoire)Texte servant à générer l'audio de prévisualisation.
string(Obligatoire)Préfixe du nom de la voix. Seuls les chiffres et les lettres sont autorisés, avec un maximum de 10 caractères. Le nom de voix généré suit le format : {target_model}-vd-{prefix}-{unique_id}language_hints array[string](Facultatif)Indications de langue pour la voix générée. Ce paramètre détermine les caractéristiques linguistiques et les schémas de prononciation de la voix. Définissez-le sur la langue correspondant à votre cas d'utilisation. La langue spécifiée doit correspondre à celle du preview_text.Actuellement, seul le premier élément est utilisé.Valeurs valides :
| |
parametersobject(Facultatif)Configuration de la conception de voix.
Propriétés sample_rate int(Facultatif)Fréquence d'échantillonnage de l'audio de prévisualisation, en Hz.
string(Facultatif)Format de l'audio de prévisualisation.
|
Corps de la réponse | |
request_idstringIdentifiant unique de cette requête. | |
outputobjectDonnées renvoyées par le modèle.
Propriétés voice_id stringIdentifiant de la voix. Utilisez-le dans le paramètre voice de l'API TTS.preview_audioobjectDonnées audio de prévisualisation.
Propriétés data stringDonnées audio de prévisualisation, encodées en Base64.sample_rate intFréquence d'échantillonnage de l'audio de prévisualisation, en Hz.response_format stringFormat de l'audio de prévisualisation.stringModèle TTS sous-jacent à la voix. | |
usageobjectInformations d'utilisation pour cette requête.
Propriétés count integerNombre de voix créées. Toujours égal à 1. |
Lister les voix
Corps de la requête | Les exemples suivants utilisent la configuration de la région China (Beijing). Remplacez {WorkspaceId} par votre identifiant réel d’espace de travail. |
modelstring(Obligatoire)Modèle de conception de voix. Valeurs valides :
| |
inputobject(Obligatoire)Objet des paramètres d'entrée.
Propriétés action string(Obligatoire)Définissez cette valeur sur list_voice.prefix string(Facultatif)Filtrez les voix par préfixe de nom.page_index integer(Facultatif)Index de la page.page_size integer(Facultatif)Nombre d'entrées par page. |
Corps de la réponse | |
request_idstringIdentifiant unique de cette requête. | |
outputobjectDonnées renvoyées par le modèle.
Propriétés voice_list array[object]Liste des voix renvoyées par la requête.
Propriétés voice_id stringIdentifiant de la voix. Utilisez-le dans le paramètre voice de l'API TTS.gmt_createstringDate de création.gmt_modifiedstringDate de dernière modification.statusstringÉtat de la voix. Pour les valeurs valides, consultez « Référence des états de voix ».voice_promptstringTexte de description de la voix.preview_textstringTexte de l'audio de prévisualisation. | |
usageobjectInformations d'utilisation pour cette requête.
Propriétés count integerToujours égal à 1. |
Consulter les détails d'une voix
Corps de la requête | Les exemples suivants utilisent la configuration de la région China (Beijing). Remplacez {WorkspaceId} par votre identifiant réel d’espace de travail. |
modelstring(Obligatoire)Modèle de conception de voix. Valeurs valides :
| |
inputobject(Obligatoire)Objet des paramètres d'entrée.
Propriétés action string(Obligatoire)Définissez cette valeur sur query_voice.voice_id string(Obligatoire)ID de la voix à consulter. |
Corps de la réponse | |
request_idstringIdentifiant unique de cette requête. | |
outputobjectDonnées renvoyées par le modèle.
Propriétés voice_id stringIdentifiant de la voix. Utilisez-le dans le paramètre voice de l'API TTS.gmt_createstringDate de création.gmt_modifiedstringDate de dernière modification.statusstringÉtat de la voix. Pour les valeurs valides, consultez « Référence des états de voix ».target_modelstringModèle TTS sous-jacent à la voix.voice_promptstringTexte de description de la voix.preview_textstringTexte de l'audio de prévisualisation. | |
usageobjectInformations d'utilisation pour cette requête.
Propriétés count integerToujours égal à 1. |
Supprimer une voix
Corps de la requête | Les exemples suivants utilisent la configuration de la région China (Beijing). Remplacez {WorkspaceId} par votre identifiant réel d’espace de travail. |
modelstring(Obligatoire)Modèle de conception de voix. Valeurs valides :
| |
inputobject(Obligatoire)Objet des paramètres d'entrée.
Propriétés action string(Obligatoire)Définissez cette valeur sur delete_voice.voice_id string(Obligatoire)ID de la voix à supprimer. |
Corps de la réponse | |
request_idstringIdentifiant unique de cette requête. | |
outputobjectDonnées retournées par le modèle. Il s’agit d’un objet vide. | |
usageobjectInformations d'utilisation pour cette requête.
Propriétés count integerToujours égal à 1. |
Référence des états de voix
Les voix créées passent par un processus de validation. Les états suivants s’appliquent à CosyVoice lorsque model est défini sur voice-enrollment.
État | Description |
|---|---|
DEPLOYING | En cours de validation ou de traitement. |
OK | Validation réussie. La voix est prête à l'emploi. |
UNDEPLOYED | Validation rejetée. La voix est inutilisable. |