Gérez les vocabulaires personnalisés via les API HTTP : création, liste, consultation, mise à jour et suppression.
Guide utilisateur : Améliorer la précision de la reconnaissance.
Endpoint
- Singapore
- China (Beijing)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/asr/customizationRemplacez {WorkspaceId} par votre véritable ID d'espace de travail.En-têtes de requête
Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
Authorization | string | Oui | Jeton Bearer. Utilisez le format |
Content-Type | string | Oui | Type de média du corps de la requête. Définissez-le sur |
Créer un vocabulaire
Corps de la requête | L'URL suivante concerne la région Singapore. Remplacez WorkspaceId par votre véritable ID d'espace de travail. Les URL varient selon la région.Les clés API diffèrent entre les régions Singapore et Beijing. Pour plus d'informations, consultez Obtenir une clé API. |
modelstring(Obligatoire)Modèle de vocabulaire personnalisé. Définissez cette valeur sur speech-biasing. | |
inputobject(Obligatoire)Paramètres d'entrée.
Propriétés action string(Obligatoire)Type d'opération. Définissez cette valeur sur create_vocabulary.target_model string(Obligatoire)Modèle de reconnaissance vocale utilisant ce vocabulaire. Cette valeur doit correspondre au modèle spécifié lors de l'appel à l'API de reconnaissance vocale.prefix string(Obligatoire)Préfixe personnalisé pour le vocabulaire. Seules les lettres minuscules et les chiffres sont autorisés, avec une longueur maximale de 10 caractères.vocabulary array[object](Obligatoire)Tableau des entrées de vocabulaire.
Propriétés text string(Obligatoire)Texte de l'entrée de vocabulaire.La langue du texte doit être prise en charge par le modèle sélectionné. Les langues prises en charge varient selon le modèle.Utilisez des mots réels plutôt que des combinaisons de caractères arbitraires afin d'améliorer la précision de la reconnaissance.Longueur maximale : 15 caractères pour un texte contenant des caractères non ASCII, ou 7 mots séparés par des espaces pour un texte exclusivement ASCII.weight integer(Obligatoire)Poids de l'entrée de vocabulaire. Valeur recommandée : 4.Valeurs valides : de 1 à 5.Si la précision de la reconnaissance ne s'améliore pas, augmentez le poids. Un poids excessivement élevé risque de réduire la précision de reconnaissance des autres mots.lang string(Facultatif)Code de langue de l'audio à reconnaître. Lorsque cette valeur est définie, le système améliore la reconnaissance des entrées de vocabulaire dans la langue spécifiée. Si vous ne pouvez pas déterminer la langue à l'avance, laissez ce paramètre vide. Le modèle détecte alors la langue automatiquement.Valeurs valides (variables selon le modèle) :
|
Corps de la réponse | |
request_idstringIdentifiant unique de cette requête. | |
outputobjectDonnées de la réponse.
Propriétés vocabulary_id stringID du vocabulaire créé. | |
usageobjectInformations d'utilisation de cette requête.
Propriétés count integerNombre de vocabulaires créés. Toujours égal à 1. |
Lister les vocabulaires
Corps de la requête | L'URL suivante concerne la région Singapore. Remplacez WorkspaceId par votre véritable ID d'espace de travail. Les URL varient selon la région.Les clés API diffèrent entre les régions Singapore et Beijing. Pour plus d'informations, consultez Obtenir une clé API. |
modelstring(Obligatoire)Modèle de vocabulaire personnalisé. Définissez cette valeur sur speech-biasing. | |
inputobject(Obligatoire)Paramètres d'entrée.
Propriétés action string(Obligatoire)Type d'opération. Définissez cette valeur sur list_vocabulary.prefix string(Facultatif)Préfixe personnalisé du vocabulaire. Lorsqu'il est spécifié, seuls les vocabulaires portant ce préfixe sont retournés.page_index integerNuméro de page, commençant à 0.Valeur par défaut : 0.page_size integerNombre d'entrées par page.Valeur par défaut : 10. |
Corps de la réponse | |
request_idstringIdentifiant unique de cette requête. | |
outputobjectDonnées de la réponse.
Propriétés vocabulary_list array[object]Vocabulaires interrogés.
Propriétés vocabulary_id stringID du vocabulaire.gmt_createstringDate de création.gmt_modifiedstringDate de dernière modification.statusstringStatut :
| |
usageobjectInformations d'utilisation de cette requête.
Propriétés count integerToujours égal à 1. |
Consulter un vocabulaire
Corps de la requête | L'URL suivante concerne la région Singapore. Remplacez WorkspaceId par votre véritable ID d'espace de travail. Les URL varient selon la région.Les clés API diffèrent entre les régions Singapore et Beijing. Pour plus d'informations, consultez Obtenir une clé API. |
modelstring(Obligatoire)Modèle de vocabulaire personnalisé. Définissez cette valeur sur speech-biasing. | |
inputobject(Obligatoire)Paramètres d'entrée.
Propriétés action string(Obligatoire)Type d'opération. Définissez cette valeur sur query_vocabulary.vocabulary_id string(Obligatoire)ID du vocabulaire à consulter. |
Corps de la réponse | |
request_idstringIdentifiant unique de cette requête. | |
outputobjectDonnées de la réponse.
Propriétés gmt_create stringDate de création.gmt_modifiedstringDate de dernière modification.statusstringStatut :
stringModèle de reconnaissance vocale utilisant ce vocabulaire. Cette valeur doit correspondre au modèle spécifié lors de l'appel à l'API de reconnaissance vocale.vocabularyarray[object]Vocabulaire interrogé.
Propriétés text stringTexte de l'entrée de vocabulaire.weight integerPoids de l'entrée de vocabulaire.lang stringLangue de l'audio à reconnaître. | |
usageobjectInformations d'utilisation de cette requête.
Propriétés count integerToujours égal à 1. |
Mettre à jour un vocabulaire
Corps de la requête | L'URL suivante concerne la région Singapore. Remplacez WorkspaceId par votre véritable ID d'espace de travail. Les URL varient selon la région.Les clés API diffèrent entre les régions Singapore et Beijing. Pour plus d'informations, consultez Obtenir une clé API. |
modelstring(Obligatoire)Modèle de vocabulaire personnalisé. Définissez cette valeur sur speech-biasing. | |
inputobject(Obligatoire)Paramètres d'entrée.
Propriétés action string(Obligatoire)Type d'opération. Définissez cette valeur sur update_vocabulary.vocabulary_id string(Obligatoire)ID du vocabulaire à mettre à jour.vocabulary array[object](Obligatoire)Nouveau vocabulaire. Celui-ci remplace intégralement les entrées existantes.
Propriétés text string(Obligatoire)Texte de l'entrée de vocabulaire.La langue du texte doit être prise en charge par le modèle sélectionné. Les langues prises en charge varient selon le modèle.Utilisez des mots réels plutôt que des combinaisons de caractères arbitraires afin d'améliorer la précision de la reconnaissance.Longueur maximale : 15 caractères pour un texte contenant des caractères non ASCII, ou 7 mots séparés par des espaces pour un texte exclusivement ASCII.weight integer(Obligatoire)Poids de l'entrée de vocabulaire. Valeur recommandée : 4.Valeurs valides : de 1 à 5.Si la précision de la reconnaissance ne s'améliore pas, augmentez le poids. Un poids excessivement élevé risque de réduire la précision de reconnaissance des autres mots.lang string(Facultatif)Code de langue de l'audio à reconnaître. Lorsque cette valeur est définie, le système améliore la reconnaissance des entrées de vocabulaire dans la langue spécifiée. Si vous ne pouvez pas déterminer la langue à l'avance, laissez ce paramètre vide. Le modèle détecte alors la langue automatiquement.Valeurs valides (variables selon le modèle) :
|
Corps de la réponse | |
request_idstringIdentifiant unique de cette requête. | |
outputobjectDonnées de la réponse. Toujours vide. | |
usageobjectInformations d'utilisation de cette requête.
Propriétés count integerNombre de vocabulaires mis à jour. Toujours égal à 1. |
Supprimer un vocabulaire
Corps de la requête | L'URL suivante concerne la région Singapore. Remplacez WorkspaceId par votre véritable ID d'espace de travail. Les URL varient selon la région.Les clés API diffèrent entre les régions Singapore et Beijing. Pour plus d'informations, consultez Obtenir une clé API. |
modelstring(Obligatoire)Modèle de vocabulaire personnalisé. Définissez cette valeur sur speech-biasing. | |
inputobject(Obligatoire)Paramètres d'entrée.
Propriétés action string(Obligatoire)Type d'opération. Définissez cette valeur sur delete_vocabulary.vocabulary_id string(Obligatoire)ID du vocabulaire à supprimer. |
Corps de la réponse | |
request_idstringIdentifiant unique de cette requête. | |
outputobjectDonnées de la réponse. Toujours vide. | |
usageobjectInformations d'utilisation de cette requête.
Propriétés count integerNombre de vocabulaires supprimés. Toujours égal à 1. |