Le SDK Python permet de créer, lister, interroger, mettre à jour et supprimer des vocabulaires personnalisés pour la reconnaissance vocale.
Endpoint
Par défaut, le SDK se connecte à l'endpoint de la région Chine (Pékin). Pour utiliser une autre région, spécifiez le paramètre region lors de la construction de dashscope.Client (par exemple, ap-southeast-1 pour la région Singapour).
- Singapore
- China (Beijing)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Remplacez {WorkspaceId} par votre ID d'espace de travail.region :
- Les clés API varient selon les régions. Utilisez la clé API correspondant à votre région.
- La configuration de région s'applique au niveau de l'instance
dashscope.Clientet n'affecte que les appels API effectués avec ce client.
client.audio.vocabularies
Entrée de ressource : la ressource client.audio.vocabularies d'une instance dashscope.Client
Fonction : gérer le cycle de vie des vocabulaires personnalisés (création, consultation, mise à jour et suppression).
Constructeur
api_key n'est pas transmis, le SDK lit automatiquement la valeur de la variable d'environnement DASHSCOPE_API_KEY.
create() - Créer un vocabulaire personnalisé
Signature de la méthode :
Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
target_model | str | 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 | str | 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 | List[dict] | Oui | Liste de mots chauds. Chaque entrée est un dictionnaire contenant les champs text, weight et lang. Pour plus d'informations, consultez Structure du dictionnaire de mots chauds. |
Type | Description |
|---|---|
Vocabulary | Objet vocabulaire ; obtenez l'ID du vocabulaire via le champ |
list() - Lister les vocabulaires personnalisés
Correspond à l'action de l'API HTTP action: list_vocabulary.
Signature de la méthode :
Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
prefix | str | Non | Préfixe personnalisé du vocabulaire. Si spécifié, seuls les vocabulaires portant ce préfixe sont retournés. |
page_index | int | Non | Numéro de page, commençant à 0. Valeur par défaut : 0. |
page_size | int | Non | Nombre d'entrées par page. Valeur par défaut : 10. |
Type | Description |
|---|---|
VocabularyList | Objet de pagination des vocabulaires ; le champ |
| Champ | Type | Description |
|---|---|---|
| vocabulary_id | str | ID du vocabulaire. |
| gmt_create | str | Date de création. |
| gmt_modified | str | Date de dernière modification. |
| status | str | État du vocabulaire :
|
get() - Interroger un vocabulaire personnalisé
Correspond à la méthode query_vocabulary() du SDK 1.x.
Signature de la méthode :
Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
vocabulary_id | str | Oui | ID du vocabulaire personnalisé à interroger. |
Type | Description |
|---|---|
Vocabulary | Objet contenant les informations détaillées du vocabulaire, incluant vocabulary, target_model, gmt_create, gmt_modified et status. |
| Champ | Type | Description |
|---|---|---|
| vocabulary | List[dict] | Contenu de la liste des mots chauds. |
| target_model | str | 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. |
| gmt_create | str | Date de création. |
| gmt_modified | str | Date de dernière modification. |
| status | str | État du vocabulaire :
|
update() - Mettre à jour un vocabulaire personnalisé
Signature de la méthode :
Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
vocabulary_id | str | Oui | ID du vocabulaire à mettre à jour. |
vocabulary | List[dict] | Oui | Nouveau vocabulaire. Ce contenu remplace intégralement les entrées existantes. |
delete() - Supprimer un vocabulaire personnalisé
Signature de la méthode :
Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
vocabulary_id | str | Oui | ID du vocabulaire à supprimer. |
Structure du dictionnaire de mots chauds
Champs de chaque dictionnaire de vocabulaire :
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| text | str | 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 incluant 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 : 1 à 5.Si la précision de la reconnaissance ne s'améliore pas, augmentez le poids. Un poids excessivement élevé risque toutefois de réduire la précision de reconnaissance des autres mots. |
| lang | str | 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étectera automatiquement la langue.Valeurs valides (variables selon le modèle) :
|