Запуск асинхронного пакетного перевода

Отправьте один или несколько документов, хранящихся в Хранилище BLOB-объектов Azure для асинхронного перевода. Служба возвращает operation-location заголовок, содержащий идентификатор задания, который используется для опроса состояния. Каждый целевой контейнер в пакете должен быть уникальным; Отправка документов в целевой контейнер, который уже переведен выходных данных вызывает ошибку конфликта файлов. targetUrl Используйте для определенного контейнера, а не общего назначения.

Метод HTTP: ВЕРСИЯ API POST : 2026-03-01

запрос

POST {endpoint}/translator/document/batches?api-version=2026-03-01

Заголовки запроса

Header Обязательный Description
Ocp-Apim-Subscription-Key Да Ключ ресурса Переводчика на портале Azure.
Ocp-Apim-Subscription-Region Conditional Требуется, если вы используете региональный ресурс.
Content-Type Да application/json

Текст запроса

Поле Обязательный Description
inputs Да Массив объектов пакетного ввода. Каждый объект определяет источник и один или несколько целевых объектов перевода.
inputs[].source Да Расположение исходного документа.
inputs[].source.sourceUrl Да URL-адрес SAS для исходного Хранилище BLOB-объектов контейнера или файла.
inputs[].source.language Нет Исходный код языка (например, en). Если опущено, служба автоматически обнаруживает язык.
inputs[].source.filter Нет Объект фильтра файлов с полями prefix , suffix чтобы ограничить включенные исходные файлы.
inputs[].targets Да Массив целевых объектов перевода.
inputs[].targets[].targetUrl Да URL-адрес SAS для целевого контейнера Хранилище BLOB-объектов. Должен быть уникальным для всех входных данных в запросе.
inputs[].targets[].language Да Код целевого языка (например, fr).
inputs[].targets[].glossaries Нет Массив объектов глоссария. Для каждого глоссария требуется glossaryUrl (URL-адрес SAS) и format (например, TSV).
inputs[].storageType Нет Тип источника хранилища. Поддерживаемые значения: Folder (по умолчанию), File.
translateTextWithinImage Нет Логический тип. Задайте для true перевода текста в изображениях .docx и .pptx файлах.

Примеры запросов

Перевод на основе NMT

curl -X POST "{endpoint}/translator/document/batches?api-version=2026-03-01" \
  -H "Ocp-Apim-Subscription-Key: {key}" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": [
      {
        "source": {
          "sourceUrl": "https://{storage}.blob.core.windows.net/source?{sas}"
        },
        "targets": [
          {
            "targetUrl": "https://{storage}.blob.core.windows.net/target-fr?{sas}",
            "language": "fr"
          }
        ]
      }
    ]
  }'

Несколько целевых языков

curl -X POST "{endpoint}/translator/document/batches?api-version=2026-03-01" \
  -H "Ocp-Apim-Subscription-Key: {key}" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": [
      {
        "source": {
          "sourceUrl": "https://{storage}.blob.core.windows.net/source?{sas}"
        },
        "targets": [
          {
            "targetUrl": "https://{storage}.blob.core.windows.net/target-es?{sas}",
            "language": "es"
          },
          {
            "targetUrl": "https://{storage}.blob.core.windows.net/target-ja?{sas}",
            "language": "ja"
          }
        ]
      }
    ]
  }'

Перевод с глоссарием

curl -X POST "{endpoint}/translator/document/batches?api-version=2026-03-01" \
  -H "Ocp-Apim-Subscription-Key: {key}" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": [
      {
        "source": {
          "sourceUrl": "https://{storage}.blob.core.windows.net/source?{sas}"
        },
        "targets": [
          {
            "targetUrl": "https://{storage}.blob.core.windows.net/target-pt?{sas}",
            "language": "pt",
            "glossaries": [
              {
                "glossaryUrl": "https://{storage}.blob.core.windows.net/glossaries/terms.tsv?{sas}",
                "format": "TSV"
              }
            ]
          }
        ]
      }
    ]
  }'

Перевод изображений в документы Word и PowerPoint

curl -X POST "{endpoint}/translator/document/batches?api-version=2026-03-01" \
  -H "Ocp-Apim-Subscription-Key: {key}" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": [
      {
        "source": {
          "sourceUrl": "https://{storage}.blob.core.windows.net/source?{sas}"
        },
        "targets": [
          {
            "targetUrl": "https://{storage}.blob.core.windows.net/target-ko?{sas}",
            "language": "ko"
          }
        ],
        "translateTextWithinImage": true
      }
    ]
  }'

Response

Коды состояния ответа

Код состояния Description
202 Accepted. Пакетное задание успешно поставлено в очередь.
400 Недопустимый запрос. Проверьте текст запроса для отсутствующих или недопустимых полей.
401 Сбой проверки подлинности. Проверьте ключ подписки.
429 Слишком много запросов. Уменьшение частоты запросов.
500 Внутренняя ошибка сервера.

Заголовки ответа

Header Description
operation-location URL-адрес, содержащий идентификатор задания для опроса. Формат: {endpoint}/translator/document/batches/{jobId}?api-version=2026-03-01.

Связанный контент

  • Last updated on