图片翻译Pro版

产品简介

图片翻译 Pro 版产品专为电商图片设计，融合多模态大模型技术，实现对图片的更精准理解，显著提高翻译质量，并不断扩展和优化多语言翻译能力。支持 100 多种（含桥接）语向。

适用场景

电商商品图、营销图，以及其他多种场景的图片。

功能介绍

• 商品主体信息保护：支持自定义选择是否翻译商品主体上的文字，可帮助保护主体信息不被翻译（如商品名称等嵌入信息）。

• 翻译后可二次编辑：支持自定义选择是否返回文字的位置、字体、颜色等布局信息（UseImageEditor），便于对译文做二次编辑。当前可直接使用返回的布局协议（GenFiles / EditInfo）自行对接；配套的图片编辑器 SDK 本期暂未开放，上线进度请关注平台通知。

• 品牌名保护：支持自定义选择是否翻译图片上的品牌名，帮助保护品牌名信息，避免被翻译。

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

接口

统一入口：提交图片 URL 与源/目标语言，由 Async 字段选择同步或异步模式。同步模式直接返回翻译结果；异步模式立即返回 TaskId，再通过查询接口获取结果。开启 UseImageEditor 时额外返回编辑器布局信息。

POST /rest/ai/image/translation/pro

异步结果查询接口

仅当 Async=true 时需要。提交成功后用返回的 TaskId 调用统一的异步查询接口轮询结果，详见异步结果查询接口。

POST /rest/ai/task/queryTaskResult

快速开始

import json

data = json.dumps({
    "ImageUrl": "https://img.alicdn.com/.../source.jpg",
    "SourceLanguage": "auto",
    "TargetLanguage": "en",
    "IncludingProductArea": True,
    "TranslatingBrandInTheProduct": True,
    "UseImageEditor": True
})

result = make_signed_request("/rest/ai/image/translation/pro", data)
# 翻译后图片
print(result["Data"]["ResultList"][0]["FileUrl"])
# 编辑器布局信息（UseImageEditor=true 时返回）
print(result["Data"]["GenFiles"][0]["EditInfo"])

请求参数

请求示例

{
  "ImageUrl": "https://img.alicdn.com/imgextra/i3/O1CN01HTDhDi28Fd85ZYs7H_!!6000000007903-0-tps-800-800.jpg",
  "SourceLanguage": "auto",
  "TargetLanguage": "en",
  "IncludingProductArea": true,
  "TranslatingBrandInTheProduct": true,
  "UseImageEditor": true
}

响应字段

响应信封与其他 API 一致：Code / Message / Success / RequestId / Data。响应内容随调用模式不同：同步模式 Data 直接包含结果；异步模式提交响应仅返回 TaskId 与 Status，最终结果通过查询接口获取。

同步模式（Async=false）

Data 直接包含翻译结果。翻译结果在 Data.ResultList；用量字段为 Data.UsageMap.ProcessedImageCount（Number）；编辑器布局信息在 Data.GenFiles（仅 UseImageEditor=true 时返回）。各字段详见下表。

同步响应示例

{
  "Data": {
    "UsageMap": { "ProcessedImageCount": 1 },
    "ResultList": [
      { "Language": "en", "FileUrl": "http://dashscope-a717.oss-cn-beijing.aliyuncs.com/.../0c3f295c-translated.jpg" }
    ],
    "GenFiles": [
      {
        "SrcImage": "https://img.alicdn.com/.../source.jpg",
        "EditInfo": {
          "ResultImageIds": ["0c39c8ae-5820-11f1-bbb2-8281b7a4eed1"],
          "RepairedUrl": "http://dashscope-a717.oss-cn-beijing.aliyuncs.com/.../repaired.png",
          "Languages": ["en"],
          "TextAreas": [
            {
              "Fontsize": 32,
              "Content": "萌趣造型·清脆响铃",
              "Color": "#515151",
              "VerticalLayout": "center",
              "HorizontalLayout": "left",
              "LineCount": 1,
              "Texts": [
                {
                  "Fontsize": 29,
                  "Language": "en",
                  "Valid": true,
                  "ImageRect": { "Height": 54, "Left": 43, "Top": 83, "Width": 418, "Degree": 0 },
                  "TextRect": { "Height": 30, "Left": 8, "Top": 95, "Width": 488, "Degree": 0 },
                  "Color": "#515151",
                  "Value": "Adorable Design · Crisp Bell Sound",
                  "VerticalLayout": "center",
                  "HorizontalLayout": "center",
                  "LineCount": 1,
                  "OvisErrMsg": "| ovis time: 0.748"
                }
              ]
            }
          ],
          "GoodsRects": { "Height": 0, "Left": 0, "Top": 0, "Width": 0, "Degree": 0 },
          "Font": ["AlibabaSans-Regular"]
        },
        "ResultList": [
          { "Language": "en", "FileUrl": "http://dashscope-a717.oss-cn-beijing.aliyuncs.com/.../0c3f295c-translated.jpg" }
        ]
      }
    ]
  },
  "RequestId": "61785C32-80C2-19A3-9E55-2C3702C84B40",
  "Message": "Success",
  "Code": "success",
  "Success": true
}

异步模式（Async=true）提交响应

Data 仅包含 Data.TaskId（String）与 Data.Status（值为 QUEUED）。请凭 TaskId 调用查询接口获取结果。

{
  "Data": {
    "TaskId": "T20260612-7f3a9c2e-0001",
    "Status": "QUEUED"
  },
  "RequestId": "61785C32-80C2-19A3-9E55-2C3702C84B40",
  "Message": "Success",
  "Code": "success",
  "Success": true
}

异步查询响应

通过查询接口轮询。Data.Status 取值 QUEUED / IN_PROGRESS / COMPLETED / FAILED，并回传 Data.TaskId。当 COMPLETED 时，Data.UsageMap / Data.ResultList / Data.GenFiles 与同步模式一致；当 FAILED 时返回 Data.FailReason（String）。

{
  "Data": {
    "TaskId": "T20260612-7f3a9c2e-0001",
    "Status": "COMPLETED",
    "UsageMap": { "ProcessedImageCount": 1 },
    "ResultList": [
      { "Language": "en", "FileUrl": "http://dashscope-a717.oss-cn-beijing.aliyuncs.com/.../0c3f295c-translated.jpg" }
    ],
    "GenFiles": [ ]
  },
  "RequestId": "61785C32-80C2-19A3-9E55-2C3702C84B40",
  "Message": "Success",
  "Code": "success",
  "Success": true
}

翻译支持的语向

语言代码采用 ISO 639-1 两位字母表示法；区域变体遵循 RFC 5646（如繁体中文 zh-tw）。支持桥接翻译，例如 zh-en、en-ar 可组合出 zh-en-ar。Pro 版额外支持源语言自动识别（auto）。

错误码

图片翻译共享统一的命名错误码体系。本能力常触发以下错误码：

• InvalidParameter -- 图片尺寸超过 4000 x 4000 像素、文件大小超过 10 MB、或格式不在支持列表（PNG / JPEG / JPG / BMP / WebP）。

• DownstreamUnavailable -- 图片 URL 无法访问或图片下载异常。

• InputContentBlocked -- 图片触发内容安全审核。

完整错误码列表及处理建议，请参见错误码。

使用限制

• 调用模式：支持同步与异步，由 Async 字段选择，默认同步。

• 计费：计费单位为每张，¥0.06/张。

• 输入图片：分辨率 ≤ 4000 x 4000 像素；文件 ≤ 10 MB；PNG / JPEG / JPG / BMP / WebP；公网可访问。

• 源语言与目标语言不能相同；支持源语言自动识别（auto）。

• QPS 上限详见频率限制。

兼容性与迁移

后续步骤

• 图片翻译标准版 -- 轻量、低成本的图片翻译，输出单张翻译图。

• 文档翻译 -- 翻译 PDF 和 Word 文件。