产品简介
图片翻译 Plus 版产品专为电商图片设计,采用 MOE(Mixture of Experts)架构,在多个小语种的翻译准确性上表现更胜一筹。建议您在以下 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 | 波兰语 |
适用场景
跨境电商主图图片及详情图片。
功能介绍
商品主体信息保护:支持自定义选择是否翻译商品主体上的文字,可帮助保护主体信息不被翻译(如商品名称等嵌入信息)。
品牌名保护:支持自定义选择是否翻译图片上的品牌名,帮助保护品牌名信息,避免被翻译。
支持翻译干预:可自定义翻译结果,包含不被翻译(ABC-ABC)、指定翻译(ABC-DEF)、不翻译(ABC-空值),常用于品牌词保护等场景。调用时传入干预词表 ID 即可生效,一般可上传 10 万条干预词,如需更多可联系平台处理。
接口
Plus 版为异步接口:通过提交接口获取 TaskId,再通过统一异步查询接口轮询结果。
提交翻译任务
POST /rest/ai/image/translation/plus查询翻译结果
复用统一异步结果查询接口,传入提交接口返回的 TaskId 轮询任务状态。
POST /rest/ai/task/queryTaskResult请求参数(提交接口)
参数 | 类型 | 是否必填 | 说明 |
| String | 是 | • 图片 URL:需公网可访问。 • 格式:png、jpeg、jpg、bmp、webp • 像素: 宽和高均不超过 4000 • 文件大小:原始文件 ≤ 10 MB |
| String | 是 | 源语言代码。支持 auto(自动检测)。示例 |
| String | 是 | 目标语言代码。推荐使用上方 12 个小语种语向。示例 |
| Boolean | 否 | 是否翻译图片主体上的文字。默认 |
| Boolean | 否 | 是否返回文字的位置、字体、颜色等布局信息。可用于二次编辑、接入图片编辑器时获取数据。开启后,查询结果的 |
| Boolean | 否 | 是否翻译图片上的品牌名。默认 |
| String | 否 | 干预词表 ID 需要在前台单独创建,并在输入参数中提供其 ID。如果提供的干预词表 ID 为空,则翻译结果将不会被修改。示例值: |
请求示例
{
"ImageUrl": "https://example.com/your-image.jpg",
"SourceLanguage": "id",
"TargetLanguage": "en",
"IncludingProductArea": false,
"UseImageEditor": true,
"TranslatingBrandInTheProduct": false
}响应字段
提交接口响应
提交接口返回异步任务 ID(Data.TaskId),随后通过统一异步查询接口轮询,状态为 COMPLETED 时取结果。
{
"Data": {
"TaskId": "6071a030-5c92-9df1-96d0-44952343439a"
},
"RequestId": "39E8A74B-F99E-1195-A5FF-3ECC5F94F304",
"Message": "Success",
"Code": "success",
"Success": true
}查询接口响应
参数 | 类型 | 说明 |
| String | 响应代码。成功为 |
| String | 任务状态: |
| String | 任务 ID。 |
| String(JSON) | 任务结果 JSON,含翻译后图片 URL;状态为 |
| Object | 用量信息。 |
| String | 请求唯一标识。 |
| Boolean | 是否成功。 |
| String | 报错信息,例如"内容包含敏感数据,请尝试其他输入"。 |
查询响应示例(COMPLETED)
Data.Result 为 JSON 字符串,解析后结构如下。genFiles 在请求时 UseImageEditor=true 时返回,含文字位置、字体、颜色等布局信息(editInfo),可用于接入图片编辑器二次编辑;resultList 为翻译后图片下载地址。
{
"Data": {
"Status": "COMPLETED",
"TaskId": "0cd7febe-4a48-9cbf-8d07-6ffd0ff9d77b",
"UsageMap": { "ProcessedImageCount": 1 },
"Result": {
"genFiles": [
{
"editInfo": {
"goodsRects": { "top": 357, "left": 0, "degree": 0, "width": 435, "height": 224 },
"languages": ["en"],
"resultImageIds": ["113cb6ee-6965-11f1-b28e-36820a81c62a"],
"textAreas": [
{
"horizontalLayout": "center",
"verticalLayout": "center",
"color": "#f7f9f7",
"fontsize": 23,
"content": "多种摆放方式",
"lineCount": 1,
"texts": [
{ "valid": true, "value": "Multiple Display Options", "fontsize": 24, "language": "en", "lineCount": 1, "color": "#f7f9f7" }
]
}
],
"repairedUrl": "http://dashscope-result.oss-cn-beijing.aliyuncs.com/xxx_repaired.jpg",
"font": ["AlibabaSans-Regular"]
},
"srcImage": "https://example.com/your-image.jpg",
"resultList": [
{ "fileUrl": "http://dashscope-result.oss-cn-beijing.aliyuncs.com/xxx_en.jpg", "language": "en" }
]
}
],
"resultList": [
{ "fileUrl": "http://dashscope-result.oss-cn-beijing.aliyuncs.com/xxx_en.jpg", "language": "en" }
]
}
},
"RequestId": "1a0f40db17816018281222384e3ce8",
"Message": "Success",
"Code": "success",
"Success": true
}错误码
完整错误码列表参见错误码。
使用限制
调用模式:异步(提交 + 查询)。查询接口无 QPS 限制,建议轮询间隔不低于 5 秒。
输入图片:PNG / JPEG / JPG / BMP / WebP;宽和高均 ≤ 4000;文件 ≤ 10 MB;公网可访问。
推荐语向:当前主打 8 个小语种语向(见产品简介),后续拓展;目标语向与图片翻译标准版 / Pro 版一致。
计费:按张计费。详见素材优化计费。