你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
容器：翻译文档
使用指定的源语言翻译文档。
请求 URL （使用 cURL）
POST 请求：
POST "http://localhost:{port}/translator/document:translate?sourceLanguage={sourceLanguage}&targetLanguage={targetLanguage}&api-version={api-version}" -F "document=@{path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file-with-file-extension}"
示例：
curl -i -X POST "http://localhost:5000/translator/document:translate?sourceLanguage=en&targetLanguage=hi&api-version=2024-05-01" -F "document=@C:\Test\test-file.md;type=text/markdown" -o "C:\translation\translated-file.md"
同步请求标头和参数
使用同步翻译处理将文档作为 HTTP 请求正文的一部分发送，并在 HTTP 响应中接收翻译后的文档。
| 查询参数 | 说明 | 条件 |
|---|---|---|
-X 或 --request POST |
-X 标志指定用于访问 API 的请求方法。 | 必需 |
{endpoint} |
文档翻译资源终结点的 URL | 必需 |
targetLanguage |
指定输出文档的语言。 目标语言必须是翻译范围中包含的支持的语言之一。 | 必需 |
sourceLanguage |
指定输入文档的语言。 如果未指定 sourceLanguage 参数，则会应用自动语言检测来确定源语言。 |
可选 |
-H 或 --header "Ocp-Apim-Subscription-Key:{KEY} |
请求头，用于指定授权访问 API 的文档翻译资源密钥。 | 必需 |
-F 或 --form |
要包含在请求中的文档文件路径。 只允许一个源文档。 | 必需 |
• document=• type={contentType}/fileExtension |
• 源文档的文件位置路径。 • 内容类型和文件扩展名。 例如： “document=@C：\Test\test-file.md;type=text/markdown” |
必需 |
-o 或 --output |
响应结果的文件路径。 | 必需 |
-F 或 --form |
要包含在请求中的可选术语表的文件路径。 术语表需要单独的 --form 标志。 |
可选 |
• glossary=• type={contentType}/fileExtension |
• 可选术语表文件的文件位置路径。 • 内容类型和文件扩展名。 示例："glossary=@C:\Test\glossary-file.txt;type=text/plain |
可选 |
✔️ 有关 contentType 的详细信息，请参阅支持的文档格式。
代码示例：文档翻译
注意
- 每个示例都运行在
localhost使用docker compose up命令指定的实例上。 - 在容器运行时，
localhost指向容器本身。 - 你不必使用
localhost:5000。 可以使用主机环境中尚未使用的任何端口。
示例文档
对于此项目，需要一个要翻译的源文档。 可以下载文档 翻译示例文档 并将其存储在文件所在的同一文件夹中 compose.yaml （container-environment）。 文件名为 document-translation-sample.docx ，源语言为英语。
查询 Azure AI 翻译器终结点（文档）
下面是使用 localhost：5000 的示例 cURL HTTP 请求：
curl -v "http://localhost:5000/translator/document:translate?sourceLanguage=en&targetLanguage=es&api-version=2024-05-01" -F "document=@document-translation-sample-docx" -o "C:\translation\translated-file.md"
成功完成后：
- 翻译后的文档随响应一起返回。
- 成功的 POST 方法返回
200 OK响应代码，指示服务创建了请求。