你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
文档翻译操作
参考
功能：Azure AI 翻译 → 文档翻译
文档翻译是 Azure AI 翻译服务的一项基于云的功能，属于 REST API 的 Azure AI 服务系列。 批文档翻译 API 可翻译所有支持的语言和方言的文档，同时保留文档结构和数据格式。 下面各表列出了可用的方法：
API 版本：2024-05-01
注意
当前版本与旧版本向后兼容。
从此当前版本开始，
get supported storage sources方法不再受支持。 Translator 服务仅支持 Azure Blob 存储。
| 请求 | 方法 | 说明 | API 路径 |
|---|---|---|---|
| Single | 同步 | Document | 翻译 |
| 翻译文档 | POST | 同步翻译单个文档。 | {document-translation-endpoint}/translator/document:translate?targetLanguage={target_language}&api-version={date} |
| 批处理 | 异步 | 文档 | 翻译 |
| 开始翻译 | POST | 启动批处理文档翻译作业。 | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| 获取所有翻译作业的状态 | GET | 请求列表和用户提交的翻译作业的状态。 | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| 获取特定翻译作业的状态 | GET | 请求特定翻译作业的状态摘要。 响应包括整体作业状态和作为该作业一部分正在翻译的文档的状态。 | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| 获取所有文档的状态 | GET | 请求翻译作业中所有文档的状态。 | {document-translation-endpoint}/translator/document/batches/{id}/documents?api-version={date} |
| 获取特定文档的状态 | GET | 请求作业中特定文档的状态。 | {document-translation-endpoint}/translator/document/batches/{id}/documents/{documentId}?api-version={date} |
| 取消翻译 | DELETE | 取消当前正在处理或排队的文档翻译作业。 | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| 获取支持的文档格式 | GET | 请求受支持的文档格式列表。 | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=document |
| 获取支持的词汇表格式 | GET | 请求支持的术语表格式列表。 | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary |
旧的
注意
- 旧版本与当前版本向后兼容。 你可以使用任一版本的操作来翻译文档。
- 建议将应用程序迁移到最新版本，以受益于增强的体验和高级功能。
| 请求 | 方法 | 说明 | API 路径 |
|---|---|---|---|
| Single | 同步 | Document | 翻译 |
| 翻译文档 | POST | 同步翻译单个文档。 | {document-translation-endpoint}/translator/document:translate?sourceLanguage={source language}&targetLanguage={target language}&api-version=2024-05-01" -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}" |
| 批处理 | 异步 | 文档 | 翻译 |
| 开始翻译 | POST | 启动批处理文档翻译作业。 | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| 获取所有翻译作业的状态 | GET | 请求列表和用户提交的翻译作业的状态。 | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| 获取特定翻译作业的状态 | GET | 请求特定翻译作业的状态摘要。 响应包括整体作业状态和作为该作业一部分正在翻译的文档的状态。 | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| 获取所有文档的状态 | GET | 请求作业中特定文档的状态。 | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents |
| 获取特定文档的状态 | GET | 请求作业中特定文档的状态。 | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents/{documentId} |
| 取消翻译 | DELETE | 取消当前正在处理或排队的文档翻译作业。 | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| 获取支持的文档格式 | GET | 请求受支持的文档格式列表。 | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/documents/formats |
| 获取支持的词汇表格式 | GET | 请求支持的术语表格式列表。 | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats |
| 获取支持的存储源 | GET | 请求受支持的存储源/选项的列表。 当前，翻译工具服务仅支持 Azure Blob 存储。 | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources |