文档翻译

产品简介

专为文档翻译研发，支持 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)

请求参数（提交）

请求参数（查询）

响应字段

提交响应

查询响应

完整示例

提交响应示例

{
  "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）均按页计费。

翻译支持语向（96）

语言代码采用 ISO 639-1；区域变体用 RFC 5646（如繁体 zh-tw）。支持桥接翻译（如 zh→en + en→ar 可得 zh→ar）。

语种识别支持语向（24）

使用限制

• 调用模式：异步。查询接口无 QPS 限制，建议轮询间隔 ≥ 5 秒。提交接口的 QPS 上限详见频率限制。

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

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

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

错误码

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

后续步骤

• 文本翻译 -- 翻译纯文本。

• 图片翻译标准版 -- 翻译图片中的文字。