图片翻译Pro版

产品简介

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

适用场景

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

功能介绍

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

• 翻译后可二次编辑：支持自定义选择是否返回文字的位置、字体、颜色等布局信息（UseImageEditor），便于对译文做二次编辑。完整字段说明见图片翻译编辑器协议。

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

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

调用模式说明

接口一：提交翻译任务

提交图片 URL 与源/目标语言；Async=false（或不传）为同步，直接返回结果；Async=true 为异步，返回 TaskId。

POST /rest/ai/image/translation/pro

完整的请求签名说明，以及 Java / Python / Go 等多语言 SDK 调用示例与在线调试，详见阿里云 OpenAPI 开发者门户：图片翻译 Pro 版 API（OpenAPI 门户）。

请求参数

请求示例

同步调用：

{
  "SourceLanguage": "auto",
  "IncludingProductArea": "true",
  "TranslatingBrandInTheProduct": "true",
  "ImageUrl": "https://example.com/your-image.jpg",
  "TargetLanguage": "en",
  "UseImageEditor": "true"
}

异步调用（增加 Async=true）：

{
  "Async": true,
  "SourceLanguage": "auto",
  "IncludingProductArea": "true",
  "TranslatingBrandInTheProduct": "true",
  "ImageUrl": "https://example.com/your-image.jpg",
  "TargetLanguage": "en",
  "UseImageEditor": "true"
}

响应参数

同步模式响应（Async=false 或未传）：Data 直接包含翻译结果。完整字段如下：

异步模式响应（Async=true）：仅返回 TaskId 与 Status，需凭 TaskId 调用查询接口获取结果。

响应示例

同步模式响应：

{
  "Data": {
    "UsageMap": { "ProcessedImageCount": 1 },
    "ResultList": [
      { "Language": "en", "FileUrl": "http://dashscope-a717.oss-cn-beijing.aliyuncs.com/.../0c3f295c-translated.jpg" }
    ],
    "GenFiles": [
      {
        "SrcImage": "https://example.com/your-image.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
}

异步模式响应（提交）：

{
  "Data": {
    "TaskId": "task_20260614_abc123def456",
    "Status": "PENDING"
  },
  "RequestId": "72896D43-91D3-2AB4-AF66-3D4813D95C51",
  "Message": "Task submitted successfully",
  "Code": "success",
  "Success": true
}

接口二：查询翻译结果（仅异步模式使用）

使用异步模式提交后，通过统一异步查询接口轮询获取翻译结果，详见异步结果查询接口。建议轮询间隔 2~5 秒，超时时间建议设为 5 分钟（待确认）。

POST /rest/ai/task/queryTaskResult

请求示例

{
  "TaskId": "task_20260614_abc123def456"
}

响应参数

任务状态枚举值：

响应示例

任务处理中：

{
  "Data": {
    "TaskId": "task_20260614_abc123def456",
    "Status": "PROCESSING"
  },
  "RequestId": "83907E54-A2E4-3BC5-B077-4E5924EA6D62",
  "Message": "Task is processing",
  "Code": "success",
  "Success": true
}

任务完成（GenFiles 结构同同步模式，此处省略明细）：

{
  "Data": {
    "TaskId": "task_20260614_abc123def456",
    "Status": "COMPLETED",
    "UsageMap": { "ProcessedImageCount": 1 },
    "ResultList": [
      { "Language": "en", "FileUrl": "http://dashscope-a717.oss-cn-beijing.aliyuncs.com/.../result.jpg" }
    ],
    "GenFiles": []
  },
  "RequestId": "94A18F65-B3F5-4CD6-C088-5F6A35FB7E73",
  "Message": "Success",
  "Code": "success",
  "Success": true
}

任务失败：

{
  "Data": {
    "TaskId": "task_20260614_abc123def456",
    "Status": "FAILED",
    "ErrorCode": "ImageDownloadFailed",
    "ErrorMessage": "Failed to download source image from the provided URL."
  },
  "RequestId": "A5B29076-C406-5DE7-D199-6078466C8F84",
  "Message": "Task failed",
  "Code": "success",
  "Success": true
}

异步调用完整流程示例

# 步骤 1：提交异步翻译任务
POST /rest/ai/image/translation/pro
{
  "Async": true,
  "ImageUrl": "https://example.com/product.jpg",
  "SourceLanguage": "zh",
  "TargetLanguage": "en"
}
# 响应：{"Data": {"TaskId": "task_xxx", "Status": "PENDING"}, ...}

# 步骤 2：轮询查询结果（建议间隔 2~5 秒）
POST /rest/ai/task/queryTaskResult
{
  "TaskId": "task_xxx"
}
# 处理中：{"Data": {"TaskId": "task_xxx", "Status": "PROCESSING"}, ...}
# 已完成：{"Data": {"TaskId": "task_xxx", "Status": "COMPLETED", "ResultList": [...], ...}, ...}

注意事项

• 异步结果保留时间：异步任务结果默认保留 7 天，过期后无法再通过 TaskId 查询，请及时获取并保存。

• 翻译结果图片有效期：结果图片 URL 带过期签名，默认有效期 7 天，请及时下载保存。

• 轮询频率：建议每 2~5 秒轮询一次，避免过于频繁导致限流。

• 超时建议：单张图片翻译通常在 10~30 秒内完成，异步轮询超时建议设为 5 分钟。

• 同步模式超时：同步调用默认超时 60 秒；如图片较大或网络较慢，建议改用异步模式。

翻译支持的语向

图片翻译 Pro 版支持 400 多种翻译语向（覆盖 156 种语言，含桥接），与文本翻译一致，并支持源语言自动识别（auto）。完整语向表与语言代码见语向映射。

错误码

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

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

• DownstreamUnavailable -- 图片 URL 无法访问或图片下载异常（异步模式下对应 ImageDownloadFailed）。

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

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

使用限制

• 输入图片：宽和高均 ≤ 4000 像素；文件 ≤ 10 MB；PNG / JPEG / JPG / BMP / WebP；公网可访问。

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

计费方式

按张计费，¥0.06 / 张。