Utilisez le SDK Java pour créer, interroger, mettre à jour et supprimer des vocabulaires personnalisés destinés à la reconnaissance vocale.
Endpoint
Le SDK utilise l'endpoint Chine (Pékin) par défaut. Pour changer de région, modifiez Constants.baseHttpApiUrl avant l'initialisation.
- Singapore
- China (Beijing)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Remplacez {WorkspaceId} par votre ID d'espace de travail.Constants.baseHttpApiUrl avant l'initialisation :
- Les clés API diffèrent selon les régions. Utilisez la clé API correspondant à votre région.
- Le paramètre de région est global et s'applique à tous les appels API DashScope.
VocabularyService
Package : com.alibaba.dashscope.audio.asr.vocabulary.VocabularyService
Description : crée, interroge, met à jour et supprime des vocabulaires personnalisés.
Constructeur
Paramètre | Type | Description |
|---|---|---|
apiKey | String | Clé API DashScope |
createVocabulary() - Créer un vocabulaire personnalisé
Signature de la méthode :
Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
targetModel | String | Oui | 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 | Oui | 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 | JsonArray | Oui | Liste des mots chauds. Chaque JsonObject contient des champs tels que text, weight et lang. Pour plus d'informations, consultez Structure de l'objet mot chaud. |
Type | Description |
|---|---|
Vocabulary | Objet de vocabulaire personnalisé contenant l'ID du vocabulaire et d'autres métadonnées. |
Exception | Description |
|---|---|
NoApiKeyException | La clé API est vide. |
InputRequiredException | Un paramètre obligatoire est vide. |
listVocabulary() - Lister les vocabulaires personnalisés
Signature de la méthode :
Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
prefix | String | Non | Préfixe personnalisé du vocabulaire. Si spécifié, seuls les vocabulaires portant ce préfixe sont retournés. |
pageIndex | int | Non | Numéro de page, commençant à 0. Valeur par défaut : 0. |
pageSize | int | Non | Nombre d'entrées par page. Valeur par défaut : 10. |
Type | Description |
|---|---|
Vocabulary[] | Tableau d'objets de vocabulaire personnalisé. |
| Champ | Type | Description |
|---|---|---|
| vocabularyId | String | ID du vocabulaire. |
| gmtCreate | String | Date de création. |
| gmtModified | String | Date de dernière modification. |
| status | String | État du vocabulaire :
|
Exception | Description |
|---|---|
NoApiKeyException | La clé API est vide. |
InputRequiredException | Un paramètre obligatoire est vide. |
queryVocabulary() - Interroger un vocabulaire personnalisé
Signature de la méthode :
Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
vocabularyId | String | Oui | ID du vocabulaire personnalisé à interroger. |
Type | Description |
|---|---|
Vocabulary | Objet |
| Champ | Type | Description |
|---|---|---|
| vocabulary | JsonArray | Contenu du vocabulaire personnalisé. |
| targetModel | String | 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. |
| gmtCreate | String | Date de création. |
| gmtModified | String | Date de dernière modification. |
| status | String | État du vocabulaire :
|
Exception | Description |
|---|---|
NoApiKeyException | La clé API est vide. |
InputRequiredException | Un paramètre obligatoire est vide. |
updateVocabulary() - Mettre à jour un vocabulaire personnalisé
Signature de la méthode :
Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
vocabularyId | String | Oui | ID du vocabulaire à mettre à jour. |
vocabulary | JsonArray | Oui | Nouveau vocabulaire. Ce contenu remplace intégralement les entrées existantes. |
Exception | Description |
|---|---|
NoApiKeyException | La clé API est vide. |
InputRequiredException | Un paramètre obligatoire est vide. |
deleteVocabulary() - Supprimer un vocabulaire personnalisé
Signature de la méthode :
Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
vocabularyId | String | Oui | ID du vocabulaire à supprimer. |
Exception | Description |
|---|---|
NoApiKeyException | La clé API est vide. |
InputRequiredException | Un paramètre obligatoire est vide. |
Classe Vocabulary
Package : com.alibaba.dashscope.audio.asr.vocabulary.Vocabulary
Description : stocke les métadonnées et le contenu d'un vocabulaire personnalisé.
Méthodes
Méthode | Type de retour | Description |
|---|---|---|
getVocabularyId() | String | Retourne l'ID du vocabulaire. |
getTargetModel() | String | Retourne le modèle cible. |
getVocabulary() | JsonArray | Retourne le contenu du vocabulaire personnalisé. |
getStatus() | String | Retourne l'état. |
getGmtCreate() | String | Retourne la date de création. |
getGmtModified() | String | Retourne la date de dernière modification. |
getData() | JsonObject | Retourne les données complètes au format JSON. |
Structure de l'objet mot chaud
Champs de chaque JsonObject de mot chaud :
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| text | String | Oui | Texte de l'entrée du vocabulaire.La langue du texte doit être prise en charge par le modèle sélectionné. Les langues compatibles 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 | int | Oui | Poids de l'entrée du 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 | Non | Code de langue de l'audio à reconnaître. Lorsque ce paramètre est défini, 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) :
|