文档翻译（2026-03-01 GA）是 Azure 翻译器 的一项云端功能，也是 Foundry Tools REST API 系列的一部分。 它提供：
- 跨所有支持的语言和方言进行翻译。
- 保留 原始文档结构和数据格式。
- 标准翻译（默认）支持神经机器翻译（NMT）引擎。
文档翻译 API 支持两个翻译过程：
异步批处理转换： 并行翻译多个文档或大型文件。 将文档上传到Blob 存储，提交批处理作业，轮询状态，然后从目标容器下载翻译的输出。 需要具有源容器和目标容器的Azure Blob 存储帐户。 有关完整演练，请参阅 快速入门：异步文档翻译 和 端到端批处理翻译工作流。
同步单文件转换： POST 单个文档并直接在响应中接收翻译的输出。 无需Azure Blob 存储。 有关完整演练，请参阅 快速入门：同步文档翻译。
版本 2026-03-01 中的新增功能
API 版本 2026-03-01 引入了以下文档翻译功能：
图像翻译：在独立图像文件（
.jpeg、、.png、.bmp）中翻译文本，.webp并将翻译的内容呈现回图像中。PDF 翻译，Azure文档智能（仅批处理）：使用Azure文档智能翻译 PDF 文件，以保留翻译输出中的布局和结构。
Office 文档中的图片内文字翻译（仅限批量处理）：翻译 Word（
.docx）和 PowerPoint（.pptx）文档中图像内嵌的文字，同时保留整体文档结构。
在您开始之前
先决条件因翻译方法而异：
- 异步批处理转换：需要Azure Blob 存储帐户和存储授权（SAS 令牌或托管标识）。
- 同步单文件翻译：只需要具有自定义域终结点的 Translator 资源。
有关完整的先决条件列表，请参阅 先决条件和设置。
主要功能
文档翻译支持每个翻译方法的不同功能。 选择方案的选项卡。
| Feature | Description |
|---|---|
| 翻译大型文件 | 异步翻译整个文档。 |
| 翻译大量文件 | 在保留文档结构和数据格式的同时，翻译所有支持的语言和方言的多个文件。 |
| 翻译图像文件格式 🆕 | • 在保持原始设计和布局的同时翻译图像中的文本。 • 支持的格式： .jpeg、、.png、 .bmp.webp• 定价：按每张图像计算。 有关详细信息，请参阅 定价。 |
| 传输Word文档（.docx）和PowerPoint文件（.pptx）中的图像文本🆕。 | 此功能可通过 批量文档翻译 API 用于 .docx 和 .pptx 文件格式。 |
| 保留源文件显式 | 在保留原始布局和格式的同时翻译文件。 |
| 应用自定义词汇表 | 使用自定义词汇表翻译文档。 |
| 自动检测文档语言 | 让文档翻译服务确定文档的语言。 |
| 翻译包含多种语言的文档内容 | 使用自动检测功能，将包含多种语言的文档翻译成目标语言。 |
语言支持
有关文档翻译功能支持的语言的完整列表，请参阅 语言支持。
开发选项
使用以下开发选项将文档翻译添加到项目和应用程序。
注意
Foundry 门户目前仅支持同步（单文件）文档翻译。 使用 REST API 或客户端库进行异步批处理文档翻译。
使用异步工作流翻译多个文档和大型文件。
| 发展选项 | Description |
|---|---|
| REST API | REST API 是一个与语言无关的接口，可用于创建 HTTP 请求和授权标头来翻译文档。 |
| 客户端库（SDK） |
客户端库 （SDKs） 是特定于语言的类、对象、方法和代码，可通过在项目中添加引用来快速使用。 目前，文档翻译对 C#/.NET 和 Python 具有编程语言支持。 |
支持的文档和术语表格式
文档翻译支持翻译输入和术语表文件的各种文件格式。 支持的格式在异步批处理和同步翻译之间略有不同。
在运行时查询支持的格式：
- 文档格式：使用 “获取支持的文档格式 ”API。
- 术语表格式：使用 Get 支持的术语表格式 API。
有关按方法列出的受支持格式的完整列表，请参阅 支持的文档格式。
文档翻译请求限制
文档翻译对请求大小、文档计数、文件大小和并发操作强制实施限制。 熟悉这些限制有助于更有效地规划批处理作业，并防止限流错误。 有关详细信息，请参阅 文档翻译请求限制。
服务限制和故障排除
如果遇到意外行为、错误或性能问题，以下资源可帮助你诊断和解决它们：
Pricing
- 使用 NMT 模型 的文档翻译按源文档中的字符数或图像数计费。 有关详细信息，请参阅 Azure 翻译器 定价。