開始批次翻譯

參考
功能： Azure Translator → 文件翻譯
API 版本（GA）： 2024-05-01
API 版本（預覽）： 2025-12-01-preview——新增影像 檔案轉換支援。
HTTP 方法： POST

• Start Translation使用方法來執行異步批次轉譯要求。
• 此方法需要具有來源和翻譯檔的記憶體容器的 Azure Blob 記憶體帳戶。

要求 URL

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

要求標頭

要求標頭如下：

BatchRequest （body）

• 每個要求都可以包含多個檔，而且必須包含每個檔的來源和目標容器。 來源媒體類型： application/json、 text/json、 application/*+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"
                }
            ]
        }
    ]
}

翻譯容器中的特定文件

• 指定 「storageType」： File。
• 建立特定 Blob/檔的來源 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"
                }
            ]
        }
    ]
}

• 您會在 POST id 方法回應標頭 start-batch-translation URL 值中找到作業 Operation-Location。 /document/ 參數後面的英數位元字串是作業的 id 作業：

  回應標頭	回應 URL
  運作地點	{document-translation-endpoint}/translator/document/9dce0aa9-78dc-41ba-8cae-2e2f3c2ff8ec？api-version=2024-05-01

• 您也可以使用 get-translations-status 要求來擷取翻譯作業及其 id清單。

將所有文件放入容器並應用詞彙表進行翻譯

{
    "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"
                }
            ]
        }
    ]
}

翻譯影像檔案

請求設定（影像檔案）

若要進行影像檔案翻譯，請透過標準批次文件 翻譯 REST API 呼叫提交您的影像，並指定 API 版本 為 2025-12-01-preview。 不需要進一步的設定。

支援格式（影像檔）

支援語言（影像檔）

有關支援語言的詳細資訊， 請參見文件翻譯語言支援。

回應狀態代碼

以下是要求傳回的可能 HTTP 狀態碼。

回覆錯誤

範例錯誤回應

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

下一步

請遵循我們的快速入門，深入瞭解如何使用文件翻譯和客戶端連結庫。