全球多语言文档翻译

接口标识: doctranslate 价格: 0.001 元/次 VIP免费异步响应

接口介绍
接口文档
在线测试

接口简介

全球多语言文档翻译接口把整份文档翻译成目标语言并输出译文文档，支持 pdf、docx、pptx、xlsx、txt、Markdown 与 HTML，单个文件最大 100MB，覆盖中、英、日、韩、西、法、德、俄等 55 种语言互译，源语言可自动识别。翻译速度约每页 5 秒，一份合同或说明书一次提交即可完成，不必拆段逐句处理，适合合同翻译、技术文档本地化与演示文稿多语言化。【调用约定】本接口为任务类：返回的 task_id 需调用 taskresult 查询终态结果（output_status 为 finish 或 fail）；status 为 not 或 processing 时请每隔5-10秒重复查询直至终态。

详细介绍

![全球多语言文档翻译接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261109/apiops_doctranslate__1794169303_11f0c9556eb5.png)

把一份文档整个交给它，指定目标语言，翻译完成后拿回一份可下载的译文文档：支持 PDF、Word、PPT、Excel、TXT、Markdown、HTML 等格式，最大 100MB，源语言自动识别，适合合同、手册、演示稿等多语言发布场景。

## 接口概述

多语言文档翻译接口面向合同翻译、技术文档本地化、演示文稿多语言化等文档级场景：传入文档文件（公网 URL、Base64 或文件 ID）与目标语言 ISO 代码，平台将文件转存后提交翻译任务，翻译完成后输出译文文档的下载地址。支持 pdf、docx、doc、pptx、ppt、xlsx、xls、txt、md/markdown/mdown/mkd、html/htm 等格式，单文件最大 100MB，旧版 doc、ppt、xls 格式自动转换后提交。源语言默认自动识别（source_lang=auto），也可显式指定。本接口为异步任务：提交后立即返回 task_id，通过任务查询接口（taskresult）获取进度与结果，判定完成的依据是 output_status=finish，完成后 output_dourl 即译文文档下载地址（有效期 24 小时，请及时下载转存），output_info 携带源语言、目标语言、任务时间线与文档类型。传入 serialnumber 可做幂等控制，重复提交返回原任务。

## 核心能力

1. **文档级整文翻译**：整份文件提交翻译，无需自行拆段、拼接，译完输出可下载的译文文档。
2. **多格式支持**：pdf、docx/doc、pptx/ppt、xlsx/xls、txt、md 家族、html 均可翻译，单文件最大 100MB。
3. **旧格式自动转换**：doc、ppt、xls 等旧版格式由平台自动转换后提交，无需预处理。
4. **源语言自动识别**：source_lang 默认 auto，也可显式指定源语言 ISO 代码。
5. **异步任务模式**：提交即返回 task_id/serialnumber/task_msg，凭 task_id 或自定义编号经 taskresult 查询进度与结果。
6. **幂等提交**：serialnumber 同接口下不可重复，重复提交返回原任务，避免重复建档。
7. **任务明细完整**：output_info 返回源语言、目标语言、提交/调度/完成时间与文档类型，便于对账与排障。

## 产品优势

- **译文即文档**：产出为可下载的译文文件，不必自行把译文灌回排版。
- **大文件友好**：100MB 上限覆盖绝大多数合同、手册与演示稿。
- **任务可追溯**：自定义编号 + 任务时间线，批量翻译时可逐单对账。
- **有效期提示明确**：译文下载地址有效期 24 小时，任务说明中会明确提醒，避免链接过期丢件。

## 效果展示

一句话理解：它就像把文件交给一位笔译译员——你不用拆页，译员翻完装订成同样一份文件交还给你。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| file | https://example.com/demo/manual_en.docx | 待翻译文档：公网 URL / data: 开头的 Base64 / fileid_ 开头的文件 ID，支持 pdf、docx、pptx、xlsx、txt、md、html，最大 100MB |
| target_lang | zh | 目标语言 ISO 代码，必传，支持 55 种语言互译 |
| source_lang | auto | 源语言，默认 auto 自动识别 |
| serialnumber | order-20261112-001 | 可选，自定义编号，用于幂等与关联查询 |

你会拿到的结果（凭 task_id 经 taskresult 查询，output_status=finish 时）：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 任务状态 | finish | `output_status`（not/processing/finish/fail） |
| 译文文档下载地址 | https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/1d/9a/20261112/manual_zh.docx | `output_dourl`，临时链接，有效期 24 小时 |
| 源语言 | auto | `output_info.source_lang` |
| 目标语言 | zh | `output_info.target_lang` |
| 文档类型 | docx | `output_info.FileType` |
| 任务时间线 | 2026-11-12 10:32:15.123456 | `output_info.submit_time` / `scheduled_time` / `end_time` |
| 任务耗时 | 38 | `output_time`（秒） |

API请求示例：

```
POST /api/v1/doctranslate
file=https://example.com/demo/manual_en.docx&target_lang=zh&source_lang=auto&serialnumber=order-20261112-001
```

提交后返回 task_id，凭它调用任务查询接口轮询，output_status=finish 即完成：

```
POST /api/v1/taskresult
task_id=ac251204976543210001
```

API响应示例（taskresult 查回的最终异步结果）：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "task_id": "ac251204976543210001",
    "serialnumber": "order-20261112-001",
    "jk_mark": "doctranslate",
    "output_status": "finish",
    "output_content": "",
    "output_dourl": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/1d/9a/20261112/manual_zh.docx",
    "output_info": {
      "source_lang": "auto",
      "target_lang": "zh",
      "submit_time": "2026-11-12 10:32:15.123456",
      "scheduled_time": "2026-11-12 10:32:16.234567",
      "end_time": "2026-11-12 10:32:53.345678",
      "FileType": "docx"
    },
    "output_msg": "翻译任务完成，参数 output_dourl 值为翻译后文档的下载 URL，有效期：24 小时，请尽快下载转存。",
    "output_time": 38
  }
}
```

解读：finish 时 output_dourl 即译后文档下载地址，它是上游生成的临时链接（有效期 24 小时，不经平台转存），请尽快下载；fail 时 output_msg 给出原因。

## 应用场景

- **合同翻译**：跨国商务合同整份翻译，供法务与业务方对照审阅
- **技术文档本地化**：产品手册、说明书批量转为目标市场语言版本
- **演示文稿多语言化**：PPT 汇报材料翻译后用于海外路演
- **报表翻译**：Excel 数据报表输出多语言版本
- **网页与资料归档**：HTML 页面、Markdown 资料统一翻译入库

## 应用案例

- **某外贸企业**：出口合同与技术附件按目标市场语言批量提交翻译，凭 serialnumber 对账每张订单的翻译任务，译文在有效期内自动下载归档。
- **某软件公司**：产品手册每个版本发布前翻译成多语言文档，旧版 doc 格式历史资料无需预处理直接提交，由平台自动转换翻译。
- **某咨询机构**：客户提供的英文报告整份翻译为中文文档，分析师基于译文文档直接批注，省去逐段复制翻译的工序。

常见问题

Q：支持哪些文件格式？有多大限制？

A：支持 pdf、docx、doc、pptx、ppt、xlsx、xls、txt、md/markdown/mdown/mkd、html/htm，单文件最大 100MB。旧版 doc、ppt、xls 由平台自动转换后提交，无需预处理。

Q：如何获取翻译结果？

A：提交后立即返回 task_id，通过任务处理查询接口（POST /api/v1/taskresult）轮询；判定完成的依据是 output_status=finish，此时 output_dourl 即译文文档下载地址，有效期 24 小时，请及时下载转存；fail 时 output_msg 给出失败原因。

Q：支持哪些语言？

A：源语言默认自动识别（source_lang=auto），也可显式指定 ISO 代码；目标语言用 ISO 代码指定（如 zh、en、ja），覆盖中英日韩法德西俄等主流语言，具体可用语种以上游翻译服务为准。

Q：serialnumber 有什么用？

A：开发者自定义查询编号，同接口下不可重复。传入后重复提交会幂等返回原任务（不重复建档），也可凭编号通过 taskresult 关联查询任务。

文档翻译整文翻译 PDF翻译文档本地化异步任务

接口地址： https://www.phpwc.cn/api/doctranslate

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`file`	string	必填	-	文件输入：公网URL / Base64(data:开头) / 文件ID(fileid_开头)。支持格式：pdf、docx、pptx、xlsx、txt、md/markdown/mdown/mkd、html
`source_lang`	string	选填	`auto`	源语种ISO代码，选传，默认auto（自动识别）。支持：zh/en/ja/ko/es/fr/de/ru等55种语言互译，详见介绍页语种表
`target_lang`	string	必填	-	目标语种ISO代码，必传。支持：zh/en/ja/ko/es/fr/de/ru等55种语言，详见介绍页语种表
`serialnumber`	string	选填	-	开发者自定义查询编号，同接口下不可重复，用于幂等和关联查询
`notice_url`	string	选填	-	转换结果完成后会将结果以JSON结构发送到此URL

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`task_id`	string	任务ID，用于通过 taskresult 接口查询任务结果
`serialnumber`	string	调用方传入的 serialnumber，用于通过 taskresult 接口查询任务结果
`task_msg`	string	预计任务耗时：每页约5秒
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

异步响应字段（调用 taskresult 返回）

本接口为异步任务类：提交后立即返回 task_id，需再调用 taskresult（传 task_id 或 serialnumber）查询结果，返回字段如下。

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	任务结果数据
`task_id`	string	任务ID（与提交响应一致）
`serialnumber`	string	调用方传入的 serialnumber（未传则为空串）
`jk_mark`	string	原调用接口标识
`output_status`	string	任务状态：not=未开始 / processing=处理中 / finish=完成 / fail=失败
`output_content`	string	完成后的文本结果（如翻译全文、问答答案），无则为空串
`output_dourl`	string	完成后的产物下载地址（图片/文档/音视频），无则为空串
`output_info`−	object	任务明细数据
`source_lang`	string	源语言（auto=自动检测）
`target_lang`	string	目标语言
`submit_time`	string	任务提交时间
`scheduled_time`	string	任务调度时间
`end_time`	string	任务完成时间
`FileType`	string	文档类型（如 pdf/docx）
`output_msg`	string	任务说明 / 状态提示文案
`output_time`	int	任务耗时（秒）
`request_id`	string	请求追踪ID

taskresult 响应 JSON 示例：

{
  "code": 0,
  "desc": "success",
  "data": {
    "task_id": "任务ID",
    "serialnumber": "调用方传入的流水号",
    "jk_mark": "doctranslate",
    "output_status": "finish",
    "output_content": "文本结果（无则空）",
    "output_dourl": "产物下载地址（无则空）",
    "output_info": { },
    "output_msg": "任务完成提示",
    "output_time": 12
  },
  "request_id": "abc123..."
}

请先登录后使用在线测试