创建凭据
在开发者中心创建 API Key。密钥只展示一次，可随时撤销。
开发者专区
文档翻译 API：把 PDF 与 Office 翻译接入业务流程
上传完整 PDF、DOCX、PPTX 或 XLSX 文件，通过统一的异步 API 创建任务、轮询状态，并下载译文 PDF 或可继续编辑的 Office 结果文件。
POST
/openapi/v1/pdf/tasksPOST
/openapi/v1/office/tasksGET
/openapi/v1/tasks/{id}GET
/openapi/v1/tasks/{id}/download
Workflow
稳定、清晰的异步调用流程
任务受理后接口立即返回，翻译在后台继续执行，你的系统可以按自己的节奏轮询结果。
提交文档
上传 PDF 或 Office 文件，指定目标语言，并携带 Idempotency-Key 保护重试。
轮询并下载
查询任务状态；任务成功后，从结果地址下载翻译后的文件。
Capabilities
面向真实文档工作流
PDF 文档翻译
提交原生或扫描 PDF，处理完成后下载译文 PDF。
Office 文档翻译
翻译 DOCX、PPTX、XLSX 文件，结果可继续编辑与交付。
共享 credits 账户
API 与网页工作台共用同一 credits 余额，可灵活组合人工与自动化流程。
Use cases
文档翻译 API 适合哪些业务场景
当处理单位是完整文件，并且译文还要进入后续业务流程时，文档翻译接口比纯文本接口更合适。
SaaS 与 RPA 流程
接收客户文档，在后台创建翻译任务、跟踪状态，再从自己的产品中交付译文文件。
知识库与资料归档
PDF 成功任务还可取得译文 Markdown，用于检索、知识库入库或受控的下游处理。
后台队列与持续任务
在任务系统中保存 data.id 与幂等键，使重试、进度、结果下载和业务记录可以追踪。
Credits
按计费页清晰扣费
PDF 与 Office 翻译按 1,500 credits / 计费页收费。PDF 按物理页，PPTX 按幻灯片，DOCX 按内嵌页数且无法读取时按 1 页，XLSX 按工作表计算。
API selection
文档翻译 API 与文本翻译 API 有什么区别
文本翻译接口处理字符串；文档翻译接口接收完整文件，通过异步任务处理，并返回可继续流转的文档结果。
| 选型维度 | 文档翻译 API | 文本翻译 API |
|---|---|---|
| 输入 | 完整 PDF、DOCX、PPTX 或 XLSX 文件 | 已提取的字符串或文本片段 |
| 输出 | 译文 PDF 等结果，或可继续编辑的 Office 文件 | 翻译后的文本或分段 |
| 流程 | 上传、任务 ID、轮询、结果下载 | 同步或批量文本请求 |
| 适用场景 | SaaS、RPA、知识库、文档业务流程 | 界面文案、对话、短字段或自建文档链路 |
进一步查看选型与接入说明： 文档翻译 API 与文本翻译 API 的区别
MCP 集成
在 AI 工作区中直接使用文档翻译
在 Codex 或其他兼容 MCP 的客户端中配置专用 API Key 后，即可查询 credits、创建文档翻译任务、轮询进度并取得短时有效的结果地址。
Remote MCP
https://www.fanyipaiban.com/translate/mcpCodex
Codex：使用已验证的安装器注册本地 stdio 桥接，重启 Codex 后在新任务中验证账户与计费。
Claude / Cursor / Trae
其他客户端：使用本地桥接，或选择能够附加 Authorization: Bearer <API_KEY> 的 Streamable HTTP 配置。
MCP 与工作台使用相同的按计费页 credits 价格，支持 PDF、DOCX、PPTX、XLSX。本地文件超过 20 MB 时请使用 REST API 上传。
FAQ
文档翻译接口常见问题
文档翻译 API 与文本翻译 API 有什么区别？
文本翻译 API 接收并返回字符串；文档翻译 API 接收完整文件，管理异步任务，并返回译文 PDF 等结果或可继续编辑的 Office 文件，调用方无需自行搭建完整的文本提取与文件重建链路。
公开 REST API 支持哪些文件格式？
当前公开 REST API 支持 PDF、DOCX、PPTX 和 XLSX。PDF 与 Office 使用不同的任务创建地址，后续共用任务轮询和主结果下载接口。
文档翻译接口会保留所有原始版式吗？
服务会返回译文 PDF 等结果或可继续编辑的 Office 文件，但复杂扫描件、公式、表格、示意图、字体和密集版式仍需要复核。接入正式流程前，应先用代表性文档测试。
批量文档翻译如何安全重试？
每次业务操作生成一个 Idempotency-Key，收到 HTTP 202 后保存 data.id 并轮询原任务。只有网络故障导致创建结果未知时才复用同一个键；接口明确返回任务创建前失败后，应修复原因并使用新键。
应该使用 REST API 还是 MCP？
后台服务、任务队列、大文件和批量流程使用 REST API；文件已在 Codex 等 AI 工作区且不超过当前 20 MB 本地文件上限时可使用 MCP。两者共用同一账户与 credits 余额。
从接入文档开始
先通过公开 Quickstart 跑通一次真实上传，读取 data.id、轮询任务并下载结果，再开始正式系统接入。