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

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

  • Статья

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

Внимание

Версия REST API 2024-11-15 преобразования речи в текст — это последняя версия, общедоступная.

  • Версия 2024-05-15-preview REST API преобразования речи в текст будет прекращена в датах, которые будут объявлены.
  • Речь в REST API v3.0, v3.1, v3.23.2-preview.1и 3.2-preview.2 будет прекращена 1 апреля 2026 года.

Дополнительные сведения об обновлении см. в руководствах по миграции службы "Речь на текст" REST API версии 3.0 до версии 3.1, версии 3.1 до версии 3.2 и версии 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 упрощается "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 проектов удаляется.

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