Udostępnij za pośrednictwem

Generowanie biblioteki klienta interfejsu API REST dla interfejsu API REST zamiany mowy na tekst

Usługa Mowa oferuje specyfikację struktury Swagger do interakcji z kilkoma interfejsami API REST używanymi do importowania danych, tworzenia modeli, testowania dokładności modelu, tworzenia niestandardowych punktów końcowych, kolejkowania transkrypcji wsadowych i zarządzania subskrypcjami. Większość operacji dostępnych za pośrednictwem niestandardowego obszaru mowy programu Speech Studio można wykonać programowo przy użyciu tych interfejsów API.

Uwaga

Usługa rozpoznawania mowy ma kilka interfejsów API REST dla zamiany mowy na tekst i zamianę tekstu na mowę.

Jednak tylko interfejs API REST zamiany mowy na tekst i niestandardowy interfejs API REST głosu są udokumentowane w specyfikacji struktury Swagger. Zapoznaj się z dokumentami, do których odwołuje się poprzedni akapit, aby uzyskać informacje na temat wszystkich innych interfejsów API REST usługi Mowa.

Generowanie kodu na podstawie specyfikacji struktury Swagger

Specyfikacja struktury Swagger ma opcje, które umożliwiają szybkie testowanie pod kątem różnych ścieżek. Jednak czasami pożądane jest wygenerowanie kodu dla wszystkich ścieżek, tworząc pojedynczą bibliotekę wywołań, na których można bazować przyszłe rozwiązania. Przyjrzyjmy się procesowi generowania biblioteki języka Python dla interfejsu API REST zamiany mowy na tekst w wersji 3.1.

Należy ustawić program Swagger na region zasobu usługi Mowa. Region można potwierdzić w części Przegląd ustawień zasobu usługi Mowa w witrynie Azure Portal. Pełna lista obsługiwanych regionów jest dostępna tutaj.

  1. W przeglądarce przejdź do strony https://editor.swagger.io
  2. Wybierz pozycję Plik, wybierz pozycję Importuj adres URL,
  3. Wprowadź adres URL https://github.com/Azure/azure-rest-api-specs/blob/master/specification/cognitiveservices/data-plane/Speech/SpeechToText/stable/v3.1/speechtotext.json i wybierz przycisk OK.
  4. Wybierz pozycję Generuj klienta i wybierz pozycję Python. Biblioteka kliencka zostanie pobrana na komputer w .zip pliku.
  5. Wyodrębnij wszystko z pobierania. Możesz użyć tar -xf polecenia , aby wyodrębnić wszystko.
  6. Zainstaluj wyodrębniony moduł w środowisku języka Python:
    pip install path/to/package/python-client
  7. Zainstalowany pakiet nosi nazwę swagger_client. Sprawdź, czy instalacja zakończyła się pomyślnie:
    python -c "import swagger_client"

Możesz użyć biblioteki języka Python wygenerowanej przy użyciu przykładów usługi Mowa w witrynie GitHub.

Następne kroki