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