图片翻译Plus版

更新时间:
复制 MD 格式

图片翻译 Plus 版专为电商图片设计,采用 MOE 架构,相比图片翻译标准版与 Pro 版,在多个小语种的翻译准确性上更胜一筹。当前推荐在 8 个语向上使用,后续会拓展更多语向。保留主体信息保护、品牌名保护与翻译干预能力。异步调用(提交 + 查询)。

产品简介

图片翻译 Plus 版产品专为电商图片设计,采用 MOE(Mixture of Experts)架构,相比于图片翻译标准版和 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

波兰语

适用场景

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

功能介绍

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

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

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

接口

Plus 版为异步接口:通过提交接口获取 TaskId,再通过统一异步查询接口轮询结果。

提交翻译任务

POST /rest/ai/image/translation/plus

查询翻译结果

复用统一异步结果查询接口,传入提交接口返回的 TaskId 轮询任务状态。

POST /rest/ai/task/queryTaskResult

请求参数(提交接口)

参数

类型

是否必填

说明

ImageUrl

String

• 图片 URL:需公网可访问。

• 格式:png、jpeg、jpg、bmp、webp

• 像素: 宽和高均不超过 4000

• 文件大小:原始文件 ≤ 10 MB

SourceLanguage

String

源语言代码。推荐使用上方 8 个小语种语向(见产品简介)。示例 "id"

TargetLanguage

String

目标语言代码。目标语向与图片翻译标准版 / Pro 版一致(131 语向,含桥接),完整语向表见语向映射。示例 "ko"

IncludingProductArea

Boolean

是否翻译图片主体上的文字。默认 false,即不翻译主体文字,保护商品名等嵌入信息。

UseImageEditor

Boolean

是否返回文字的位置、字体、颜色等布局信息。可用于二次编辑、接入图片编辑器时获取数据。开启后,查询结果的 Data.Result.genFiles[].editInfo 中返回完整布局参数。默认 false。示例值:false

TranslatingBrandInTheProduct

Boolean

是否翻译图片上的品牌名。默认 false,即不翻译品牌名,保护品牌信息。

Glossary

String

干预词表 ID 需要在前台单独创建,并在输入参数中提供其 ID。如果提供的干预词表 ID 为空,则翻译结果将不会被修改。示例值:"glossary_1"

请求示例

{
  "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
}

查询接口响应

参数

类型

说明

Code

String

响应代码。成功为 success

Data.Status

String

任务状态:QUEUED(排队中)/ IN_PROGRESS(执行中)/ COMPLETED(已完成)/ FAILED(失败)。

Data.TaskId

String

任务 ID。

Data.Result

String(JSON)

任务结果 JSON,含翻译后图片 URL;状态为 FAILED 时返回失败原因。

Data.UsageMap

Object

用量信息。

RequestId

String

请求唯一标识。

Success

Boolean

是否成功。

Message

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 版一致。

  • 计费:按张计费。详见素材优化计费。