Partager via

Générer une bibliothèque de client d’API REST pour l’API REST de reconnaissance vocale

Le service Speech offre une spécification Swagger pour interagir avec quelques API REST utilisées pour importer des données, créer des modèles, tester le niveau de justesse des modèles, créer des points de terminaison personnalisés, mettre en file d’attente des transcriptions par lots et gérer des abonnements. La plupart des opérations disponibles par le biais de la zone Reconnaissance vocale personnalisée de Speech Studio peuvent être effectuées par programme à l’aide de ces API.

Notes

Le service Speech fournit quelques API REST pour la reconnaissance vocale et la synthèse vocale.

Toutefois, seules l’API REST de reconnaissance vocale et l’API REST de voix personnalisée sont documentées dans la spécification Swagger. Consultez les documents mentionnés dans le paragraphe précédent pour obtenir des informations sur toutes les autres API REST du service Speech.

Génération de code à partir de la spécification Swagger

La spécification Swagger comporte des options qui vous permettent de tester rapidement divers parcours. En revanche, il est parfois souhaitable de générer du code pour tous les parcours, en créant une bibliothèque unique d’appels sur laquelle vous pouvez baser les futures solutions. Examinons le processus de génération d’une bibliothèque Python pour l’API REST de reconnaissance vocale version 3.1.

Vous devez définir Swagger sur la région de votre ressource Speech. Vous pouvez confirmer la région dans la partie Vue d’ensemble de vos paramètres de ressource Speech dans le portail Azure. La liste complète des régions prises en charge est disponible ici.

  1. Dans un navigateur, accédez à https://editor.swagger.io.
  2. Sélectionnez Fichier, puis Importer l’URL,
  3. Entrez l’URL https://github.com/Azure/azure-rest-api-specs/blob/master/specification/cognitiveservices/data-plane/Speech/SpeechToText/stable/v3.1/speechtotext.json, puis sélectionnez OK.
  4. Sélectionnez Générer un client, puis python. La bibliothèque de client est téléchargée sur votre ordinateur sous forme de fichier .zip.
  5. Extrayez l'ensemble du téléchargement. Vous pouvez utiliser tar -xf pour tout extraire.
  6. Installez le module extrait dans votre environnement Python :
    pip install path/to/package/python-client
  7. Le package installé porte le nom suivant : swagger_client. Vérifiez que l’installation a réussi :
    python -c "import swagger_client"

Vous pouvez utiliser la bibliothèque Python que vous avez générée avec les exemples du service Speech sur GitHub.

Étapes suivantes