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

Справочная
функция. Azure AI Translator → ВЕРСИЯ API перевода
документов: 2024-05-01
HTTP: POST

• Start Translation Используйте метод для выполнения асинхронного запроса на пакетное преобразование.
• Для этого метода требуется учетная запись хранения BLOB-объектов Azure с контейнерами хранения для исходных и переведенных документов.

Запросить URL-адрес

  curl -i -X POST "{document-translation-endpoint}/translator/document/batches?api-version={date}"

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

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

BatchRequest (body)

• Каждый запрос может содержать несколько документов и должен содержать исходный и целевой контейнер для каждого документа. Типы исходных носителей: application/json, text/jsonapplication/*+json.

• Если задан фильтр по префиксу и суффиксу, он используется для соответствующей фильтрации папок. Префикс применяется к подпути после имени контейнера.

• Глоссарии можно включить в запрос. Если глоссарий имеет недопустимый формат или недоступен во время перевода, в статусе документа будет отображаться ошибка.

• Если файл с тем же именем уже существует в целевом месте назначения, задание завершается ошибкой.

• Параметр targetUrl для каждого целевого языка должен быть уникальным.

{
  "inputs": [
    {
      "source": {
        "sourceUrl": "https://myblob.blob.core.windows.net/Container/",
        "filter": {
          "prefix": "FolderA",
          "suffix": ".txt"
        },
        "language": "en",
        "storageSource": "AzureBlob"
      },
      "targets": [
        {
          "targetUrl": "https://myblob.blob.core.windows.net/TargetUrl/",
          "category": "general",
          "language": "fr",
          "glossaries": [
            {
              "glossaryUrl": "https://myblob.blob.core.windows.net/Container/myglossary.xlf",
              "format": "XLIFF",
              "version": "2.0",
              "storageSource": "AzureBlob"
            }
          ],
          "storageSource": "AzureBlob"
        }
      ],
      "storageType": "Folder"
    }
  ],
}

Входные данные

Определение запроса на перевод входного пакета.

inputs.source

Определение исходных данных.

inputs.targets

Определение целевых и глоссарий данных.

inputs.storageType

Определение сущности хранилища для входных документов.

Параметры

Определение запроса на перевод входного пакета.

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

Ниже приведены примеры пакетных запросов.

Перевод всех документов в контейнере

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en?{SAS-token-query-string}"
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target-fr?{SAS-token-query-string}",
                    "language": "fr"
                }
            ]
        }
    ]
}

Перевод всех документов в контейнере с применением глоссариев

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en?{SAS-token-query-string}"
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target-fr?{SAS-token-query-string}",
                    "language": "fr",
                    "glossaries": [
                        {
                            "glossaryUrl": "https://my.blob.core.windows.net/glossaries/en-fr.xlf?{SAS-token-query-string}",
                            "format": "xliff",
                            "version": "1.2"
                        }
                    ]

                }
            ]
        }
    ]
}

Перевод содержимого указанной папки в контейнере

Убедитесь, что имя папки (учитывает регистр) в качестве префикса в фильтре.

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en?{SAS-token-query-string}",
                "filter": {
                    "prefix": "MyFolder/"
                }
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target-fr?{SAS-token-query-string}",
                    "language": "fr"
                }
            ]
        }
    ]
}

Перевод конкретного документа в контейнере

• Укажите "storageType": File.
• Создайте исходный URL-адрес и маркер SAS для конкретного большого двоичного объекта или документа.
• Укажите имя целевого файла в целевом URL-адресе. Маркер SAS по-прежнему предназначен для контейнера.

В этом примере запроса показан один документ, переведенный на два целевых языка.

{
    "inputs": [
        {
            "storageType": "File",
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en/source-english.docx?{SAS-token-query-string}"
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target/try/Target-Spanish.docx?{SAS-token-query-string}",
                    "language": "es"
                },
                {
                    "targetUrl": "https://my.blob.core.windows.net/target/try/Target-German.docx?{SAS-token-query-string}",
                    "language": "de"
                }
            ]
        }
    ]
}

• Задание можно найти в значении id URL-адреса url-адреса заголовка Operation-Location ответа метода POSTstart-batch-translation. Буквенно-цифровой строкой, следующей за /document/ параметром, является задание idоперации:

  Заголовок ответа	URL-адрес ответа
  Operation-Location	{document-translation-endpoint}/translator/document/9dce0aa9-78dc-41ba-8cae-2e2f3c2ff8ec?api-version=2024-05-01

• Вы также можете использовать запрос на получение списка заданий перевода и их idсостояний.

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

Ниже приведены возможные коды состояния HTTP, которые возвращает запрос.

Отклик в случае ошибки

Пример ответа с ошибкой

{
  "error": {
    "code": "ServiceUnavailable",
    "message": "Service is temporary unavailable",
    "innerError": {
      "code": "ServiceTemporaryUnavailable",
      "message": "Service is currently unavailable.  Please try again later"
    }
  }
}

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

Воспользуйтесь информацией, приведенной в данном кратком руководстве, чтобы узнать больше об использовании перевода документов и клиентской библиотеки.