Руководство по REST API перевода документов (2026-03-01)

REST API перевода документов (версия 2026-03-01) поддерживает две модели перевода и набор операций обнаружения. Синхронный перевод обрабатывает один документ без Хранилище BLOB-объектов и возвращает переведенный файл напрямую. Асинхронный пакетный перевод обрабатывает один или несколько документов, хранящихся в Хранилище BLOB-объектов Azure, и позволяет проискать состояние. Обе модели используют нейронный машинный перевод (NMT) по умолчанию.

Для всех запросов требуется конечная точка личного домена. Формат — https://{your-resource-name}.cognitiveservices.azure.com/.

Замечание

Сведения о существующих приложениях, использующих более ранние API, см. в руководстве по REST API перевода документов прежних версий.

Синхронные операции

Операция Метод Description Reference
Перевод документа POST Перевод одного документа и получение переведенных выходных данных в ответе. Не требуется Хранилище BLOB-объектов. Синхронный перевод документов

Асинхронные пакетные операции

Операция Метод Description Reference
Запуск пакетного перевода POST Отправьте один или несколько документов для асинхронного перевода. Документы должны находиться в Хранилище BLOB-объектов Azure. Возвращает идентификатор задания. Запуск пакетного перевода
Получение сведений о состоянии перевода GET Получение общего состояния и сводки документа для определенного пакетного задания. Опрос до тех пор, пока задание не достигнет состояния терминала. Получение состояния перевода
Получение состояния для всех переводов GET Перечислите все задания пакетного перевода, отправленные в ресурс. Поддерживает фильтрацию и разбиение по страницам. Получение состояния для всех заданий перевода
Получение состояния для всех документов GET Получение состояния каждого документа для всех документов в определенном задании. Получение состояния для всех документов
Получение статуса для определенного документа GET Получение сведений о состоянии и выходных данных для одного документа в задании. Получение состояния для определенного документа
Отмена перевода DELETE Отмена задания, которое находится в очереди или выполняется. Отмена перевода

Операции обнаружения

Операция Метод Description Reference
Получение сведений о поддерживаемых форматах документов GET Получение списка поддерживаемых форматов документов и их типов MIME. Получение поддерживаемых форматов документов
Получение сведений о поддерживаемых форматах глоссария GET Получение списка поддерживаемых форматов глоссарий и их типов MIME. Получение поддерживаемых форматов глоссарий