AI 助理
文档备案控制台
官方文档
首页

图片翻译标准版

更新时间：
复制 MD 格式
我的收藏

翻译图片中嵌入的文字，同时保留原始排版布局。同步调用，输出翻译后的图片 URL；支持开启编辑器协议（UseImageEditor）获取文字位置、字体、颜色等图层信息。如需更高翻译质量与源语言自动识别，请使用图片翻译 Pro 版。

产品简介

图片翻译产品专为电商图片定制，支持 100 多种语向，精确处理图片内的复杂文本布局，并确保翻译内容能够与图片内容匹配，帮助电商平台和开发者轻松实现图像内容的多语言转换与呈现。

适用场景

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

功能介绍

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

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

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

  • 图层信息（编辑器协议）：开启 UseImageEditor 后，响应额外返回文字的位置、字体、颜色等布局信息，可用于二次编辑。完整字段说明见图片翻译编辑器协议。

接口

同步接口：提交图片 URL 与源/目标语言，直接返回翻译后的图片 URL。

POST /rest/ai/image/translation

快速开始

import json

data = json.dumps({
    "ImageUrl": "https://example.com/product-image.jpg",
    "SourceLanguage": "en",
    "TargetLanguage": "ko"
})

result = make_signed_request("/rest/ai/image/translation", data)
print(result["Data"]["ImageUrl"])  # 翻译后的图片 URL

请求参数

参数

类型

是否必填

说明

ImageUrl

String

是

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

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

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

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

SourceLanguage

String

是

源语言代码。支持的语向见下方支持的语向。示例 "en"。

TargetLanguage

String

是

目标语言代码。支持的语向见下方支持的语向。示例 "ko"。

IncludingProductArea

Boolean

否

是否翻译商品主体上的文字。默认 false，仅翻译非主体上文字（保护商品名等嵌入信息）。

TranslatingBrandInTheProduct

Boolean

否

是否翻译图片上的品牌名。默认 false（保留品牌名不翻译）。

Glossary

String

否

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

示例值："glossary_1"

UseImageEditor

Boolean

否

是否返回文字的位置、字体、颜色等布局信息（图层信息）。设为 true 时响应额外返回编辑器协议 Data.GenFiles，可接入图片编辑器进行二次编辑。默认 false。完整字段说明见图片翻译编辑器协议。

请求示例

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

响应字段

字段

类型

说明

Code

String

业务状态码。成功为 success。

Message

String

状态描述信息，成功时为 Success；失败时为错误信息。

Success

Boolean

是否成功：true 代表成功，false 代表失败。

RequestId

String

请求唯一标识。

Data.ImageUrl

String

翻译后的图片 URL。

Data.UsageMap.ProcessedImageCount

Number

已处理图片张数（用量）。

Data.GenFiles

Array[Object]

编辑器协议数组（仅 UseImageEditor=true 时返回）。每个元素含 SrcImage / EditInfo / ResultList；完整字段说明见图片翻译编辑器协议。

编辑器协议字段说明（Data.GenFiles）

当 UseImageEditor=true 时，响应额外返回以下字段。完整说明另见图片翻译编辑器协议。

序号

参数名称

数据类型

参数描述及示例值

1

Data.GenFiles

Array[Object]

编辑器协议信息（仅 UseImageEditor=true 时返回）。

2

Data.GenFiles.SrcImage

String

原图 URL。

3

Data.GenFiles.EditInfo

Object

编辑器详细信息。

4

Data.GenFiles.EditInfo.ResultImageIds

Array[String]

翻译后图片全局 Id 集合。

5

Data.GenFiles.EditInfo.RepairedUrl

String

所有文字涂抹后的图片 URL。

6

Data.GenFiles.EditInfo.Languages

Array[String]

翻译语种列表。

7

Data.GenFiles.EditInfo.TextAreas

Array[Object]

文本框列表。

8

Data.GenFiles.EditInfo.TextAreas.Fontsize

Number

字体大小。

9

Data.GenFiles.EditInfo.TextAreas.Content

String

翻译前的文本。

10

Data.GenFiles.EditInfo.TextAreas.Color

String

文字颜色，如 #ffffff。

11

Data.GenFiles.EditInfo.TextAreas.VerticalLayout

String

垂直对齐：center / top / down。

12

Data.GenFiles.EditInfo.TextAreas.HorizontalLayout

String

水平对齐：center / left / right。

13

Data.GenFiles.EditInfo.TextAreas.LineCount

Number

文本框行数。

14

Data.GenFiles.EditInfo.TextAreas.Texts

Array[Object]

翻译后文本列表。

15

Data.GenFiles.EditInfo.TextAreas.Texts.Fontsize

Number

字体大小。

16

Data.GenFiles.EditInfo.TextAreas.Texts.Language

String

语言。

17

Data.GenFiles.EditInfo.TextAreas.Texts.Valid

Boolean

TextItem 是否有效。

18

Data.GenFiles.EditInfo.TextAreas.Texts.ImageRect

Object

图片修复区域。

19

Data.GenFiles.EditInfo.TextAreas.Texts.TextRect

Object

文本框区域。

20

Data.GenFiles.EditInfo.TextAreas.Texts.Color

String

颜色。

21

Data.GenFiles.EditInfo.TextAreas.Texts.Value

String

翻译后文本。

22

Data.GenFiles.EditInfo.TextAreas.Texts.VerticalLayout

String

垂直对齐。

23

Data.GenFiles.EditInfo.TextAreas.Texts.HorizontalLayout

String

水平对齐。

24

Data.GenFiles.EditInfo.TextAreas.Texts.LineCount

Number

文本框行数。

25

Data.GenFiles.EditInfo.GoodsRects

Object

商品框区域。

26

Data.GenFiles.EditInfo.Font

Array[String]

字体类型。

27

Data.GenFiles.ResultList

Array[Object]

翻译结果集合。

28

Data.GenFiles.ResultList.Language

String

翻译语种。

29

Data.GenFiles.ResultList.FileUrl

String

翻译后图片 URL。

响应示例

{
  "Data": {
    "ImageUrl": "http://dashscope-a717.oss-cn-beijing.aliyuncs.com/.../7901aa74-translated.jpg",
    "UsageMap": { "ProcessedImageCount": 1 }
  },
  "RequestId": "1CEC4D94-905A-1ED1-A7B4-1BFEFFB3D850",
  "Message": "Success",
  "Code": "success",
  "Success": true
}

翻译支持的语向

图片翻译标准版支持 127 个翻译语向（覆盖 49 种语言，含桥接；繁体中文 zh-tw 经简体中文 zh 桥接），与文本翻译一致。完整语向表与语言代码见语向映射。

错误码

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

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

  • DownstreamUnavailable -- 图片 URL 无法访问或图片下载异常。

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

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

使用限制

  • 调用模式：同步。

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

  • 源语言与目标语言不能相同。

  • 计费：计费单位：每张，¥0.015/张。详见翻译类计费。

  • 标准版不支持源语言自动识别（需明确传入 SourceLanguage）；如需自动识别请使用 Pro 版。

后续步骤

  • 图片翻译 Pro 版 -- 多模态大模型驱动，翻译质量更高，支持源语言自动识别、异步模式与翻译干预策略。

  • 文档翻译 -- 翻译 PDF 和 Word 文件。

上一篇：文本翻译下一篇：图片翻译Pro版