你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
同步文档翻译
参考
功能：Azure AI 翻译→文档翻译
API 版本：2024-05-01
HTTP 方法：POST
- 使用
translate document方法同步翻译单个文档。 - 该方法不需要有 Azure Blob 存储帐户。
- 最终响应包含翻译后的文档，会直接返回给调用客户端。
重要
对文档翻译功能的所有 API 请求都需要有位于 Azure 门户资源概述页上的自定义域终结点。
请求 URL
curl -i -X POST "{your-document-translation-endpoint}/translator/document:translate?sourceLanguage=en&targetLanguage=hi&api-version={date}" -H "Ocp-Apim-Subscription-Key:{your-key}" -F "document={path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -F "glossary={path-to-your-glossary-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file}"
请求标头
若要通过 REST API 调用同步翻译功能，需在每个请求中包含以下标头。
| 标头 | 值 | 条件 |
|---|---|---|
| Ocp-Apim-Subscription-Key | Azure 门户中的翻译器服务密钥。 | • 必需 |
请求参数
查询字符串参数：
必需的参数
| 查询参数 | 说明 |
|---|---|
| api-version | 必需参数。 客户端所请求的 API 的版本。 当前值是 2024-05-01。 |
| targetLanguage | 必需参数。 指定输出文档的语言。 目标语言必须是翻译范围中包含的支持的语言之一。 |
| • document= • type= |
必需的参数。 • 源文档和文件格式类型的文件位置的路径。• 示例："document=@C:\Test\Test-file.txt;type=text/html |
| --output | 必需参数。 • 目标文件位置的文件路径。 翻译后的文件将打印到输出文件中。 • 示例："C:\Test\Test-file-output.txt"。 文件扩展名应与源文件相同。 |
可选参数
| 查询参数 | 说明 |
|---|---|
| sourceLanguage | 指定输入文档的语言。 如果未指定 sourceLanguage 参数，则会应用自动语言检测来确定源语言。 |
| • glossary= • type= |
• 自定义术语表和文件格式类型的文件位置的路径。 • 例如："glossary=@D:\Test\SDT\test-simple-glossary.csv;type=text/csv |
| allowFallback | •一个布尔值，指定当自定义系统不存在时允许服务回退到的 generalnn 系统。 可能的值为 true（默认） 或false。 • allowFallback=false 指定翻译应仅使用针对由此请求指定的类型而训练的系统。•如果未通过特定类别找到任何系统，此请求会返回 400 状态代码。 • allowFallback=true 指定当自定义系统不存在时允许服务回退到的 generalnn 系统。 |
| category | 一个字符串，指定翻译的类别（领域）。 此参数用于从一个使用自定义翻译工具构建的自定义系统获取翻译。 若要使用已部署的自定义系统进行同步文档翻译，请将自定义翻译工具项目详细信息中的 Category ID 添加到 category 参数。 默认值为：generalnn。 |
请求正文
| 名称 | 描述 | 内容类型 | 条件 |
|---|---|---|---|
| 文档 | 要翻译的源文档。 | 任何一种受支持的文档格式。 | 必需 |
| 术语表 | 包含翻译过程中要使用的具有定义的术语列表的文档。 | 任何受支持的术语表格式。 | 可选 |