Поделиться через

Создание клиентской библиотеки REST API для преобразования речи в текстовый REST API

Служба "Речь" предлагает спецификацию Swagger для взаимодействия с несколькими ИНТЕРФЕЙСами REST API, используемыми для импорта данных, создания моделей, точности тестовой модели, создания пользовательских конечных точек, очередей пакетных транскрибирования и управления подписками. Большинство операций, доступных через настраиваемую область речи в Speech Studio , можно выполнить программным способом с помощью этих API.

Примечание.

Служба "Речь" имеет несколько ИНТЕРФЕЙСов REST API для преобразования речи в текст и текст речи.

Однако в спецификации Swagger документируются только речь в REST API текста и пользовательском REST API голосовой связи. Ознакомьтесь с документами, на которые ссылается предыдущий абзац, для получения сведений обо всех остальных ИНТЕРФЕЙСАх REST API службы "Речь".

Создание кода из спецификации Swagger

Спецификация Swagger содержит возможности, которые позволяют быстро протестировать различные пути. Тем не менее иногда желательно сгенерировать код для всех путей, создав единую библиотеку вызовов, на основе которой потом можно будет создавать решения. Рассмотрим процесс создания библиотеки Python для преобразования речи в текст REST API версии 3.1.

Необходимо задать Swagger региону ресурса "Речь". Вы можете подтвердить регион в обзорной части параметров ресурсов речи в портал Azure. Полный список поддерживаемых регионов можно посмотреть здесь.

  1. В браузере перейдите в раздел https://editor.swagger.io
  2. Выбор файла, выбор URL-адреса импорта,
  3. Введите URL-адрес https://github.com/Azure/azure-rest-api-specs/blob/master/specification/cognitiveservices/data-plane/Speech/SpeechToText/stable/v3.1/speechtotext.json и нажмите кнопку "ОК".
  4. Выберите "Создать клиент" и выберите python. Клиентская библиотека загружается на компьютер в файл .zip.
  5. Извлеките содержимое скачиваемого файла. Вы можете использовать tar -xf для извлечения всех данных.
  6. Установите извлеченный модуль в среду Python:
    pip install path/to/package/python-client
  7. Установленный пакет с именем swagger_client. Убедитесь, что установка выполнена успешно:
    python -c "import swagger_client"

Вы можете использовать созданную библиотеку Python с примерами для службы распознавания речи на портале GitHub.

Следующие шаги