开始批量翻译

参考
功能：Azure AI 翻译→文档翻译
API 版本：2024-05-01
HTTP 方法：POST

• 使用 Start Translation 方法执行异步批量翻译请求。
• 该方法需要一个 Azure Blob 存储帐户，其中包含用于源文档和已翻译文档的存储容器。

请求 URL

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

请求标头

请求标头为：

BatchRequest（正文）

• 每个请求可包含多个文档，并且必须包含每个文档的源和目标容器。 源媒体类型：application/json、text/json、application/*+json。

• 前缀和后缀筛选器（如有提供）用于筛选文件夹。 前缀位于子路径中的容器名称后。

• 请求中可以包含术语表。 如果术语表无效或在翻译过程中无法查看，则文档状态中将显示错误。

• 如果目标中已存在同名的文件，则作业将失败。

• 每个目标语言的 targetUrl 必须唯一。

{
  "inputs": [
    {
      "source": {
        "sourceUrl": "https://myblob.blob.core.chinacloudapi.cn/Container/",
        "filter": {
          "prefix": "FolderA",
          "suffix": ".txt"
        },
        "language": "en",
        "storageSource": "AzureBlob"
      },
      "targets": [
        {
          "targetUrl": "https://myblob.blob.core.chinacloudapi.cn/TargetUrl/",
          "category": "general",
          "language": "fr",
          "glossaries": [
            {
              "glossaryUrl": "https://myblob.blob.core.chinacloudapi.cn/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.chinacloudapi.cn/source-en?{SAS-token-query-string}"
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.chinacloudapi.cn/target-fr?{SAS-token-query-string}",
                    "language": "fr"
                }
            ]
        }
    ]
}

翻译应用术语表的容器中的所有文档

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

                }
            ]
        }
    ]
}

翻译容器中的特定文件夹

确保将文件夹名称（区分大小写）指定为筛选器中的前缀。

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

翻译容器中的特定文档

• 指定“storageType“：File。
• 为特定 blob/文档创建源 URL 和 SAS 令牌。
• 将目标文件名指定为目标 URL 的一部分，但是 SAS 令牌仍适用于容器。

此示例请求显示翻译成两种目标语言的单个文档。

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

• 可以在 POST start-batch-translation方法响应头 Operation-Location URL 值中查找作业 id。 /document/ 参数后面的字母数字字符串是操作的作业 id：

  响应头	响应 URL
  Operation-Location	{document-translation-endpoint}/translator/document/9dce0aa9-78dc-41ba-8cae-2e2f3c2ff8ec?api-version=2024-05-01

• 还可以使用 get-translations-status 请求来检索翻译作业及其 id 的列表。

响应状态代码

下面是请求可能返回的 HTTP 状态代码。

错误响应

错误响应示例

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

后续步骤

遵循快速入门，详细了解如何使用文档翻译和客户端库。