Auf Englisch lesen

Freigeben über

Generieren einer REST-API-Clientbibliothek für die Spracherkennungs-REST-API

  • Artikel

Der Speech-Dienst verfügt über eine Swagger-Spezifikation zum Interagieren mit einigen REST-APIs, die zum Importieren von Daten, Erstellen von Modellen, Testen der Modellgenauigkeit, Erstellen von benutzerdefinierten Endpunkten, Einreihen von Batchtranskriptionen in die Warteschlange und Verwalten von Abonnements verwendet werden. Die meisten Vorgänge, die über den Custom Speech-Bereich von Speech Studio verfügbar sind, können mit diesen APIs programmgesteuert durchgeführt werden.

Hinweis

Der Speech-Dienst verfügt über mehrere REST-APIs für die Spracherkennung und die Sprachsynthese.

In der Swagger-Spezifikation sind jedoch nur die Sprachausgabe für DIE REST-API und die benutzerdefinierte VoIP-REST-API dokumentiert. Informationen zu allen anderen REST-APIs der Speech-Dienste finden Sie in den Dokumenten, auf die im vorherigen Abschnitt verwiesen wurde.

Generieren von Code über die Swagger-Spezifikation

Die Swagger-Spezifikation verfügt über Optionen, die Ihnen das schnelle Testen für verschiedene Pfade ermöglichen. Es kann aber auch der Fall sein, dass Code für alle Pfade generiert werden soll, um eine zentrale Bibliothek mit Aufrufen zu erstellen, die als Grundlage für zukünftige Lösungen dienen kann. Nun wird der Prozess zum Generieren einer Python-Bibliothek für die Spracherkennungs-REST-API Version 3.1 beschrieben.

Swagger muss auf die Region Ihrer Speech-Ressource festgelegt werden. Die Region können Sie im Azure-Portal im Bereich Übersicht Ihrer Speech-Ressourceneinstellungen überprüfen. Die vollständige Liste der unterstützten Regionen finden Sie hier.

  1. Navigieren Sie in einem Browser zu https://editor.swagger.io.
  2. Wählen Sie Datei und URL importieren aus,
  3. Geben Sie die URL https://github.com/Azure/azure-rest-api-specs/blob/master/specification/cognitiveservices/data-plane/Speech/SpeechToText/stable/v3.1/speechtotext.json ein, und wählen Sie OK aus.
  4. Wählen Sie Client generieren und dann Python aus. Die Clientbibliothek wird in einer .zip-Datei auf den Computer heruntergeladen.
  5. Extrahieren Sie alles aus dem Download. Sie können tar -xf verwenden, um alles zu extrahieren.
  6. Installieren Sie das extrahierte Modul in Ihrer Python-Umgebung:
    pip install path/to/package/python-client
  7. Das installierte Paket hat den Namen swagger_client. Überprüfen Sie, ob die Installation erfolgreich war:
    python -c "import swagger_client"

Sie können die Python-Bibliothek verwenden, die Sie mit den Speech-Dienstbeispielen auf GitHub generiert haben.

Nächste Schritte