AI 助理
文档备案控制台
官方文档
首页

文档翻译

更新时间：
复制 MD 格式
我的收藏

翻译 PDF 或 Word 文档，保留原始排版和图片内文字翻译。支持 100+ 语向（含桥接），单份 PDF / Word 均 100 页以内。本 API 采用异步处理（提交 + 查询）。

产品简介

专为文档翻译研发，支持 100 多种（含桥接）语向之间的互译，满足多场景、多页数、高复杂度文档翻译，暂不支持扫描件。在以下方面表现出色：

  • 内容准确性：翻译准确性，参数与单位准确性。

  • 结构合理性：整体排版连续性，页面边距与布局还原性。

适用场景

跨境电商商品说明书、合同、协议、商务议案、资质文件、教材课件等多种场景。

功能介绍

  • 支持 PDF 及 Word 两种格式，支持源文档中包含多种语言（详细语言清单见下方支持的语向）。

  • 支持文档中图片内含文字的翻译，以及图表、特殊符号等复杂翻译场景。

  • 支持翻译后排版高度还原。

  • 单份 PDF / Word 均支持 100 页以内。

  • 支持翻译干预：不被翻译（ABC-ABC）、指定翻译（ABC-DEF）、不翻译（ABC-空值），常用于品牌词保护等场景。调用时传入干预词表 ID 即可生效，一般可上传 10 万条干预词，如需更多可联系平台处理。

接口

提交翻译任务

POST /ai/document/translation

查询翻译结果

POST /ai/document/translation/result

快速开始

import json
import time

data = json.dumps({
    "Url": "https://example.com/report.pdf",
    "TargetLanguage": "en",
    "FileType": "PDF"
})
submit_result = make_signed_request("/ai/document/translation", data)
task_id = submit_result["Data"]["TaskId"]

while True:
    query_data = json.dumps({"TaskId": task_id})
    result = make_signed_request("/ai/document/translation/result", query_data)
    status = result["Data"]["Status"]
    if status == "COMPLETED":
        # Data.Result 是 JSON 字符串，包含 url 字段
        print("下载链接:", json.loads(result["Data"]["Result"])["url"])
        break
    elif status == "FAILED":
        print("任务失败:", result["Data"]["Result"])
        break
    time.sleep(10)

请求参数（提交）

参数

类型

是否必填

说明

Url

String

是

待翻译文档的 OSS URL 路径，需可公网访问。

TargetLanguage

String

是

目标语言代码。源语言自动检测，无需传入。

FileType

String

是

文档类型：PDF 或 word。容量限制：Word ≤ 200 MB / 100 页；PDF ≤ 200 MB / 100 页。

Glossary

String

否

干预词表 ID 需要在前台单独创建，并在输入参数中提供其 ID。如果提供的干预词表 ID 为空，则翻译结果将不会被修改。

示例值："glossary_1"

请求参数（查询）

参数

类型

是否必填

说明

TaskId

String

是

提交接口返回的任务 ID。

响应字段

提交响应

字段

类型

说明

Code

String

业务状态码。成功为 Success。

Message

String

错误描述。成功时为 "ok"。

RequestId

String

请求唯一标识，排查问题时联系技术支持需提供。

Data.TaskId

String

唯一任务标识，用于后续查询。

查询响应

字段

类型

说明

Data.Status

String

任务状态：QUEUED（排队中）、IN_PROGRESS（执行中）、COMPLETED（完成）、FAILED（失败）。

Data.TaskId

String

异步任务唯一标识。

Data.Result

String（JSON）

任务结果（JSON 字符串）。COMPLETED 时含 url（翻译结果下载 URL）；FAILED 时返回失败原因。

Data.Result.url

String

翻译结果文档的下载 URL（Data.Result JSON 解析后的 url 字段）。

Data.UsageMap.ProcessedDocumentPageCount

Number

处理的文档页数，用于计费核对。

完整示例

提交响应示例

{
  "Data": {
    "TaskId": "6071a030-5c92-9df1-96d0-44952343439a"
  },
  "RequestId": "39E8A74B-F99E-1195-A5FF-3ECC5F94F304",
  "Message": "Success",
  "Code": "success",
  "Success": true
}

查询响应示例

{
  "Data": {
    "Status": "COMPLETED",
    "TaskId": "8b760f7a-56e8-9042-b113-e175797eb2ec",
    "Result": "{\"url\": \"https://aib-innovation-oss.oss-accelerate.aliyuncs.com/AI_Business/OdIpM/translated_ar.pdf?Expires=...\", \"usageMap\": \"{\\\"ProcessedDocumentPageCount\\\":2}\"}",
    "UsageMap": { "ProcessedDocumentPageCount": "2" }
  },
  "RequestId": "F260E502-3FA9-1F79-99A6-F751CE8559C7",
  "Message": "Success",
  "Code": "success",
  "Success": true
}

计费方式

所有文档类型（PDF、Word）均按页计费。

支持的语言

文档翻译共支持 131 个翻译语向（覆盖 50 种语言，含桥接；繁体中文 zh-tw 经简体中文 zh 桥接），并支持 24 个语种的语种识别。完整翻译语向表、语种识别语向表与语言代码对照，统一见语向映射。

使用限制

  • 调用模式：异步。查询接口无 QPS 限制，建议轮询间隔 ≥ 5 秒。

  • 支持的文件类型：PDF（≤ 200 MB / 100 页）、Word docx（≤ 200 MB / 100 页）。

  • 支持的语言：100+ 种（含桥接），与文本翻译一致。完整语向清单见支持的语言。

  • 计费：计费单位为每页（PDF / Word），¥0.08/页。详见翻译类计费。

错误码

常见错误码：InvalidParameter（参数缺失或不合规，如 URL 不可访问、FileType 不支持）、InputContentBlocked（文档内容违规）、DownstreamUnavailable（文档下载失败或下游服务暂不可用）、InternalError（系统繁忙）。完整列表参见错误码。

后续步骤

上一篇：图片翻译Plus版下一篇：语种识别