Перенос кода из версии 3.2 в версию 2024-11-15

REST API преобразования речи в текст используется для быстрого транскрибирования, пакетной транскрибирования и пользовательской речи. В этой статье описывается изменение версии 3.2 до версии 2024-11-15.

Базовый путь

Пользовательский API речи переключился со схемы версирования на основе пути на схему на основе параметра запроса в соответствии с общими схемами версирования API в Azure. Это требовало изменения используемого базового пути. Обновите путь с /speechtotext/v3.2 на /speechtotext и добавьте версию API с ?api-version=2024-11-15 ко всем запросам.

Наборы данных

email Свойство и подключенный процесс уведомлений по электронной почте удаляются из API.

Свойство duration в ответах набора данных переименовано из duration в durationMilliseconds и теперь является обычным числом вместо строки, отформатированной как ISO8601 (P1D2H3M4S...), для упрощения дальнейшей обработки.

Параметр sasValidityInSeconds запроса переименован в sasLifetimeMinutes для получения файлов. Использование разрешено только для учетной записи с отключенной функцией BYOS. Для учетных записей с поддержкой BYOS URL-адреса SAS не возвращаются.

Свойство project удаляется в запросах на создание.

Модели

Удалено свойство text в запросе на создание модели. Альтернативой является создание набора данных с текстовым содержимым и создание набора данных сначала, который затем используется для создания модели.

email Свойство и подключенный процесс уведомлений по электронной почте удаляются из API.

Параметр sasValidityInSeconds запроса переименован в sasLifetimeMinutes для получения файлов. Использование разрешено только для учетной записи с отключенной функцией BYOS (принести собственное хранилище). Для учетных записей с поддержкой BYOS URL-адреса SAS не возвращаются.

Теперь для GET models/id/manifest операции всегда требуется ненулевое время существования SAS. Соответствующее sasValidityInSeconds свойство переименовано в sasLifetimeMinutes.

Свойство project удаляется в запросах на создание.

Оценки

Параметр sasValidityInSeconds запроса переименован в sasLifetimeMinutes для получения файлов. Использование разрешено только для учетной записи с отключенной функцией BYOS. Для учетных записей с поддержкой BYOS URL-адреса SAS не возвращаются.

Свойство project удаляется в запросах на создание

email Свойство и подключенный процесс уведомлений по электронной почте удаляются из API.

Конечные точки

API для извлечения и удаления файлов журналов конечных точек удаляется. Настраиваемая речь теперь поддерживает BYOS (принести собственное хранилище). Только учетные записи с включённым BYOS могут включать ведение журнала на конечных точках модели. Это обеспечивает полное управление файлами журналов на хранилище клиентов вместо прокси API.

Удалена поддержка timeToLive в создании конечных точек.

В запросе на создание конечной точки удалено свойство text. Альтернативой является создание набора данных с текстовым содержимым и создание набора данных сначала, который затем используется для создания модели. Затем эту модель можно использовать для создания конечной точки.

Ссылки конечных точек теперь возвращают только конечную точку подключения websocket, используемую для пакета SDK.

Свойство project удаляется в запросах на создание.

email Свойство и подключенный процесс уведомлений по электронной почте удаляются из API.

Расшифровки

Удалено свойство верхнего уровня diarizationEnabled транскрибирования. Конфигурация диаризации упрощается "diarization": {"maxSpeakers": 2,"enabled": true}. Свойство maxSpeakers является необязательным и по умолчанию имеет значение 2. Свойство enabled требуется для диаризации.

Создание транскрипции: timeToLive переименовано в timeToLiveHours, включая изменение формата с строки в формате ISO8601 на целое число (int), представляющее количество часов.

Свойство duration в ответах транскрибирования переименовано с duration на durationMilliseconds и теперь представляется обычным числом вместо строки, форматированной по ISO8601 (P1D2H3M4S...), что позволяет упростить обработку. Файлы результатов транскрибирования добавляют это свойство для согласованности с API.

Параметр sasValidityInSeconds запроса переименован в sasLifetimeMinutes для получения файлов. Использование разрешено только для учетной записи с отключенной функцией BYOS. Для учетных записей с поддержкой BYOS URL-адреса SAS не возвращаются.

Свойство project удаляется в запросах на создание.

email Свойство и подключенный процесс уведомлений по электронной почте удаляются из API.

Проекты

API проектов удаляется.

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

• Преобразование речи в текстовый REST API
• Справочная документация по REST API преобразования речи в текст 2024-11-15