快速入门：同步文档翻译

使用同步翻译可以翻译单个文档并直接在 API 响应中接收输出 ， 无需Azure Blob 存储。 将此方法用于交互式方案、轻型集成或单文件请求。

先决条件

需要以下资源之一才能开始：

  • Azure AI 翻译 翻译器资源。

有关详细信息，请参阅 先决条件和设置。

步骤 1：准备文档

同步 API 接受每个请求一个文档作为多部分表单上传。 确认文档是否为 受支持的文档格式 之一并记下其 MIME 类型 - 在请求中指定文档，以便服务可以正确分析文件。

步骤 2：提交同步翻译请求

向 /document:translate 端点发送 POST 请求，并将您的文档作为 multipart 表单字段附上。 使用 targetLanguage 查询参数指定目标语言。 该 -o 选项将翻译的文档写入本地文件。 将 {endpoint} 和 {key} 替换为您的 Translator 资源中的值。

curl -i -X POST "{endpoint}/translator/document:translate?targetLanguage=fr&api-version=2026-03-01" \
  -H "Ocp-Apim-Subscription-Key: {key}" \
  -F "document=@sample.docx;type=application/vnd.openxmlformats-officedocument.wordprocessingml.document" \
  -o translated.docx

步骤 3：查看响应

成功的请求返回 200 OK 响应。 翻译后的文档直接在响应正文中返回，并写入你指定的 -o输出文件。

可选：包括术语表

若要应用自定义术语，请将术语表文件添加为同一请求中的第二个表单字段：

-F "glossary=@glossary.tsv;type=text/tab-separated-values"

有关详细信息，请参阅 创建和使用术语表。

  • Last updated on