文档翻译

整篇文档的保版式翻译，任务式异步接口，支持常见办公文档格式。

能力与场景

文档翻译面向整篇办公文档，解析后保版式翻译，以异步任务方式运行。典型场景：公文与合同的整篇翻译、教材讲义蒙汉双语化、批量资料迁移。提交任务后接口立即返回任务 ID，处理进度与结果通过查询接口获取。

本产品提供 fast / standard / pro 三个档位（表单字段 mode）：快速档以轻量模型逐段翻译；标准档以标准模型翻译并对长文档自动抽取全文术语契约；专业档以旗舰模型翻译，全文启用术语契约并在译后做整篇统稿，译文质量与每页单价逐级提升。

端点列表

方法	路径	说明
POST	/v1/translate/document	提交文档翻译任务（上传文件）
GET	/v1/translate/document/{taskId}	查询任务进度与结果下载地址

每个端点的请求参数、响应结构与可运行代码示例见本页下方「API 参考」（随接口定义自动生成，始终与线上一致）。

调用要点

• 任务为异步处理：建议按指数退避轮询查询接口（如 2s/4s/8s……），不要以固定高频轮询。
• mode 决定档位与每页单价：fast（最快最省）、standard（默认，均衡）、pro（质量最高，含全文术语契约与统稿）。
• 按文档页数计费，提交成功即按解析出的页数与所选档位单价预扣，任务失败或取消自动冲正；各档免费额度独立计数。
• 支持的文件格式与单文件大小上限以 API 参考为准；扫描件（图片型 PDF）的翻译质量取决于 OCR 效果。

支持语种

• 源语言无需传参，由引擎自动检测（列表内语种之间可互译）。
• 目标语言取值与文本翻译一致；传统蒙古文（mw）译文默认国标编码。

目标语言（参数 targetLang）：

代码	语种	说明
zh	中文	简体中文
en	英语	—
mw	传统蒙古文	回鹘式蒙古文（竖排），Unicode 国标编码
xle_mw	西里尔蒙古文	蒙古国通用的西里尔字母书写
es	西班牙语	—
fr	法语	—
de	德语	—
ja	日语	—
ko	韩语	—
ru	俄语	—
pt	葡萄牙语	—
ar	阿拉伯语	—
hi	印地语	—
id	印尼语	—
yue	粤语	繁体书写
la	拉丁转写	传统蒙古文的拉丁字母转写
ipa	国际音标	输出 IPA 音标标注
kk	哈萨克语	—
bo	藏语	—
ug	维吾尔语	—

完整代码表与各产品对照见「语种与语言代码」。

计费

按页计费，单价随所选档位不同（请求参数 mode）：

档位	mode	说明
快速档	fast	轻量模型驱动，响应最快、单价最低，适合海量内容、实时场景与对成本敏感的批量处理。
标准档	standard	标准模型驱动，质量与成本均衡，覆盖绝大多数通用翻译场景（默认档）。
专业档	pro	旗舰模型驱动并附加译文精修，适合出版、合同、公文等对译文质量要求最高的场景。

• 不传 mode 时按标准档计费。
• 每档的免费额度独立计数、互不挤占，均于月初重置，优先于余额抵扣。
• 仅对成功的调用计费；失败调用不扣费。
• 各档实时单价与免费额度见本页下方「当前价格」（后台调价即时生效），总规则见「计费与免费额度」。