你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

容器：翻译文档（预览版）

项目
05/04/2024

重要

Azure AI 翻译公共预览版提供对当前开发中的功能的早期访问。
在正式发布 (GA) 之前，根据用户反馈，功能、方法和流程可能会发生更改。

使用指定的源语言翻译文档。

请求 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=2023-11-01-preview" -F "document=@C:\Test\test-file.md;type=text/markdown" -o "C:\translation\translated-file.md"

同步请求标头和参数

使用同步翻译处理将文档作为 HTTP 请求正文的一部分发送，并在 HTTP 响应中接收翻译后的文档。

查询参数	说明	条件
`-X` 或 `--requestPOST`	-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=2023-11-01-preview" -F "document=@document-translation-sample-docx" -o "C:\translation\translated-file.md"

成功完成后：

翻译后的文档随响应一起返回。
成功的 POST 方法返回 200 OK 响应代码，指示服务创建了请求。

后续步骤

了解有关同步文档翻译的详细信息

通过