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

1、产品简介

图片翻译Plus版产品专为电商图片设计，采用MOE架构，相比于图片翻译标准版和Pro版，在多个小语种的翻译准确性上表现更胜一筹，建议您在以下12个语向上进行使用，后续会拓展更多语向。

序号	源语言		目标语言
序号	语言代码	中文名称	语言代码	中文名称
1	en	英语	ar	阿拉伯语
2	en	英语	id	印尼语
3	en	英语	th	泰语
4	en	英语	ko	韩语
5	en	英语	ja	日语
6	en	英语	vi	越南语
7	en	英语	ru	俄语
8	en	英语	tl	菲律宾语
9	en	英语	es	西班牙语
10	en	英语	fr	法语
11	en	英语	de	德语
12	en	英语	pl	波兰语

2、适用场景

跨境电商主图图片及详情图片。

3、功能介绍

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

4、接入准备与调用流程

4.1前置说明

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

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

5、开发指南

5.1提交接口

5.1.1请求参数

参数名称	数据类型	是否必填	参数描述及示例值
ImageUrl	String	必填	• 图片 URL：需公网可访问。 • 格式：png、jpeg、jpg、bmp、webp • 像素：宽和高均不超过 4000 • 文件大小：原始文件 ≤ 10 MB
SourceLanguage	String	必填	源语言代码；支持 auto（自动检测）。示例值："en"
TargetLanguage	String	必填	目标语言代码；推荐使用上方 12 个小语种语向。示例值："ko"
IncludingProductArea	Boolean	非必填	选择是否翻译图片主体上文字；这可以帮助您保护信息，避免翻译诸如商品名称等嵌入信息。如示例图中，红框中的文本代表主体上文字，蓝框中的文本代表非主体上文字。示例值："false"
UseImageEditor	Boolean	非必填	是否返回文字的位置、字体、颜色等布局信息。可用于二次编辑接入图片编辑器时获取数据使用。您可再调用图片翻译结果数据查询接口获取完整参数信息示例值："false"
TranslatingBrandInTheProduct	Boolean	非必填	选择是否翻译图片上的品牌名。这可以帮助您保护品牌名信息，避免被翻译。默认：false（即代表不翻译品牌名）如示例图中，“懒角落”代表品牌名。示例值："false"
Glossary	String	非必填	干预词表 ID。干预词表 ID需要单独创建，并在输入参数中提供其 ID。如果提供的干预词表 ID 为空，则翻译结果将不会被修改。干预词表创建平台地址：

5.1.2请求示例

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

5.1.3响应参数

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

参数名称	数据类型	参数描述及示例值
Code	Number	提交调用响应代码；成功示例为 success。
Data	Object	任务提交数据。
Data.TaskId	String	异步任务标识，用于结果查询和通知关联；不以示例前缀作为业务校验规则。
RequestId	string	本次请求唯一标识，用于问题排查与链路追踪
Success	Boolean	提交调用是否成功，不代表翻译已完成。；true 代表成功，false 代表失败。
Message	String	报错信息，例如“内容包含敏感数据，请尝试其他输入”。

5.1.4提交任务响应示例

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

5.1.5 限流与异常处理

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

6、计费方式

详见：计费说明