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

图片翻译标准版

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

翻译图片中嵌入的文字，同时保留原始排版布局。同步调用，输出翻译后的图片 URL。如需更高翻译质量、源语言自动识别及编辑器布局信息，请使用图片翻译 Pro 版。

产品简介

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

适用场景

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

功能介绍

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

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

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

接口

同步接口：提交图片 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"

请求示例

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

响应字段

字段

类型

说明

Code

String

业务状态码。成功为 success。

Message

String

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

Success

Boolean

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

RequestId

String

请求唯一标识。

Data.ImageUrl

String

翻译后的图片 URL。

Data.UsageMap.ProcessedImageCount

Number

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

响应示例

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

翻译支持的语向

图片翻译标准版支持 131 个翻译语向（覆盖 50 种语言，含桥接；繁体中文 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版