图片翻译标准版（异步）-电商经营助手-阿里云帮助中心

1、产品简介

图片翻译产品专为电商图片定制，支持 400 多种语向（含桥接），精确处理图片内的复杂文本布局，并确保翻译内容能够与图片内容匹配，帮助电商平台和开发者轻松实现图像内容的多语言转换与呈现。同时，产品支持返回图片中文字的位置、字体、颜色等图层信息，便于接入图片编辑器对翻译结果进行二次编辑。

2、适用场景

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

3、功能介绍

商品主体信息保护：支持自定义选择是否翻译商品主体上的文字，可以帮您保护主体信息不被翻译，避免翻译诸如商品名称等嵌入信息。
品牌名保护：支持自定义选择是否翻译图片上的品牌名，这可以帮助您保护品牌名信息，避免被翻译。
翻译后可二次编辑（图层信息）：支持自定义选择是否返回文字的位置、字体、颜色等图层信息，可用于接入图片编辑器对翻译结果进行二次编辑。编辑器 SDK 包的开放进展请关注平台通知。
支持翻译干预：可自定义翻译结果，包含不被翻译（ABC-ABC）、指定翻译（ABC-DEF）、不翻译（ABC-空值），常用于品牌词保护等场景。只需在调用接口时传入相应的干预词表 ID 即可实现，可满足您在不同场景下的翻译需求。一般您可以上传 10 万条干预词，如有更多需要可以联系平台进行处理。

4、接入准备与调用流程

4.1前置说明

图片翻译标准版支持同步和异步两种调用方式。本文介绍异步调用接口，如需使用同步调用，请参阅图片翻译标准版。

图片翻译标准版及其他能力的异步接口共用结果获取流程、RocketMQ 订阅规则、消息加密协议、依赖配置，以及 Java 消费与解密代码。

异步调用的接入流程，订阅规则，消息格式与加密协议，以及详细的接入方案请参阅异步接口调用说明。

5、开发指南

5.1 请求参数

参数名称	类型	是否必填	参数描述及示例值
ImageUrl	String	必填	• 图片 URL：需公网可访问。 • 格式：png、jpeg、jpg、bmp、webp • 像素：宽和高均不超过 4000 • 文件大小：原始文件 ≤ 10 MB
SourceLanguage	String	必填	源语言代码；支持的语向见 4.6。示例值："en"
TargetLanguage	String	必填	目标语言代码；支持的语向见 4.6。示例值："ko"
IncludingProductArea	Boolean	非必填	选择是否翻译图片主体上的文字。设为 false 可保护主体信息不被翻译（如商品名称等嵌入信息）。默认值：false。示例值："false"
TranslatingBrandInTheProduct	Boolean	非必填	选择是否翻译图片上的品牌名。设为 false 可保护品牌名信息不被翻译。默认值：false。示例值："false"
UseImageEditor	Boolean	非必填	是否返回文字的位置、字体、颜色等图层信息。设为 true 时返回图层信息，可用于接入图片编辑器进行二次编辑。默认值：false。示例值："false"
Glossary	String	非必填	干预词表 ID，需要在前台单独创建并在输入参数中提供其 ID。如果提供的干预词表 ID 为空，则翻译结果将不会被修改。示例值："glossary_1"

5.2 请求示例

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

5.3 响应参数

提交成功后，接口返回 Data.TaskId，不包含译文及最终用量信息。Success=true 仅表示提交调用成功，不代表翻译任务完成。请保存任务ID，并按照异步接口调用说明查询任务状态或接收结果通知。

参数名称	数据类型	参数描述及示例值
RequestId	String	本次提交请求 ID，用于排查。
Code	String	提交调用响应代码；成功示例为 success。
Success	Boolean	提交调用是否成功，不代表翻译已完成。
Message	String	调用说明；成功示例为 Success，失败时读取实际错误信息。
Data	Object	任务提交数据。
Data.TaskId	String	异步任务标识，用于结果查询和通知关联；不以示例前缀作为业务校验规则。

5.4 提交任务响应示例

{
  "Data": {
    "TaskId": "TID_2c6519c0-834b-4529-9d89-f92e2763890f"
  },
  "RequestId": "01A11FA1-F64C-14E9-A486-E0CCF9A4F13D",
  "Message": "Success",
  "Code": "success",
  "Success": true
}

5.6 限流与异常处理

接入技术方案规定，异步提交默认按主账号维度限流，默认 1 QPS；提高额度需提供 UID 并联系产品同学配置。
QueryAsyncTaskResult 公开元数据配置为 5 次/秒，实际账号额度与维度以服务方配置为准。多个在途文本任务应统一管理查询频率，按业务可接受延迟设置间隔，对限流及暂时性错误采用退避与随机抖动，并设置本地等待上限；
外层调用失败时读取 Code、Message、RequestId；任务 FAILED 时读取实际业务结果中的失败信息。通用错误码参考错误码，不新增未验证错误码。提交重试可能创建新任务，现有资料未定义文本任务幂等提交参数或取消接口。
排障保留提交及查询 RequestId、TaskId、调用时间与状态，不记录完整待译文本、明文消息或密钥。通用消费确认、重投、幂等与查询兜底要求按公共接入文档执行。

6、翻译支持的语向

支持的语向详见语向映射

7、计费方式

详见：计费说明