中文版
快速试用控制台

图片翻译API 调用说明

图片翻译

GET/POST /ai/image/translation

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

请求参数

参数名称类型必填参数描述及示例值

imageUrl

String

是

图片要求：不超过 4000x4000像素；大小不超过 10MB；

支持png、jpeg、jpg、bmp、webp。

sourceLanguage

String

是

源语言代码；支持的语向见附录的支持语向列表。

示例值："en"

targetLanguage

String

是

目标语言代码；支持的语向见附录的支持语向列表。

示例值："ko"

translatingTextInTheProduct

Boolean

否

选择是否翻译图片主体上文字；

这可以帮助您保护信息，避免翻译诸如商品名称等嵌入信息。

如示例图中，红框中的文本代表主体上文字，蓝框中的文本代表非主体上文字。

示例值："false"

useImageEditor

Boolean

否

示例值："false"

请求示例

IopClient client = new IopClient(url, appkey, appSecret);
IopRequest request = new IopRequest();
request.setApiName("/ai/image/translation");
request.addApiParameter("imageUrl", "https://ae01.alicdn.com/kf/S68468a838ad04cc081a4bd2db32745f1y/M3-Light-emitting-Bluetooth-Headset-Folding-LED-Card-Wireless-Headset-TYPE-C-Charging-Multi-scene-Use.jpg_.webp");
request.addApiParameter("sourceLanguage", "en");
request.addApiParameter("targetLanguage", "fr");
request.addApiParameter("translatingTextInTheProduct", "false");
request.addApiParameter("useImageEditor", "false");
IopResponse response = client.execute(request);
System.out.println(response.getBody());
Thread.sleep(10);

响应参数

参数名称类型Description描述

resCode

Number

响应代码； 200 代表调用成功，其他的响应代码可以参考错误码信息。

data

Object

返回结果的结构体信息。

data.imageUrl

String

图片翻译结果生成后的图片 URL。

data.imageEditorId

String

图片编辑器所需的参数“协议查询ID”（请求参数 useImageEditor 为 true 时，需提供此ID）。

requestId

String

请求 ID；用来识别唯一一次请求调用。

success

Boolean

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

resMessage

String

报错信息，例如“内容包含敏感数据，请尝试其他输入”。

响应示例

{
  "data": {
    "imageUrl": "https://nhci-image.oss-ap-southeast-1.aliyuncs.com/tufan%2F512506ce-32a5-11ef-9dd3-00163e08a26f.png?OSSAccessKeyId=LTAI5tCv9DpB7gYic1oGsAyv&Expires=4935959108&Signature=vf2a7lOn8uvvsfDfyeJNiYMls9Y%3D"
  },
  "requestId": "2140c5a117192871068067414ee3ad",
  "success": true,
  "resCode": 200,
  "resMessage": "success",
  "code": "0",
  "request_id": "2140cc8017192871068088228",
  "_trace_id_": "2140c5a117192871068067414ee3ad"
}

错误码

错误码错误信息描述

501

rate limit exceed

当前接口已达到限流上限,请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们增加当前限制值。

700

invalid input

输入参数的格式不符合要求，resMessage 将返回详细的不符合要求的字段。

703

image size exceeds the limit

请求参数中的图像大小超过限制；图像不得超过 4000x4000 像素。

704

invalid image form

请求参数中的图像格式无效。

705

image file size exceeds the

请求参数中的图像大小超过限制；图像大小不得超过 10MB。

801

model failed

内部调用异常，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们进行故障排除。

900

tpp url error

内部调用异常，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们进行故障排除。

1000

content has sensitive data, please try other input

内容包含敏感数据，请尝试其他输入。

1001

content control failed, please retry

风控服务运行异常，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们。

1002

content risk filter failed, please contact us

风控服务运行异常，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们。

附录

支持图片翻译的语向

图片翻译产品支持以下表中列出语向的图片翻译。我们会持续添加更多语向。

如您有具体需求，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们。

源语言目标语言

中文（简体）

阿拉伯语

中文（简体）

中文（繁体）

中文（简体）

英语

中文（简体）

法语

中文（简体）

日语

中文（简体）

韩语

中文（简体）

葡萄牙语

中文（简体）

俄语

中文（简体）

西班牙语

中文（简体）

越南语

中文（简体）

泰语

中文（简体）

印尼语

中文（简体）

俄语

中文（简体）

德语

中文（简体）

意大利语

中文（简体）

荷兰语

中文（简体）

波兰语

中文（简体）

乌克兰语

中文（简体）

土耳其语

英语

阿拉伯语

英语

中文（繁体）

英语

中文（繁体）

英语

越南语

英语

法语

英语

日语

英语

韩语

英语

葡萄牙语

英语

俄语

英语

西班牙语

英语

泰语

英语

印尼语

英语

俄语

英语

德语

英语

意大利语

英语

荷兰语

英语

波兰语

英语

乌克兰语

英语

土耳其语

土耳其语

阿拉伯语

土耳其语

英语

语言代码

语言代码采用 ISO 639-1 标准的两位字母表示法。对于特定语言的区域变体，遵循 RFC 5646 格式，即在语言代码后加短横线，并接上 ISO 3166 的两位国家/地区代码。例如，繁体中文的语言代码是 zh-tw。

点击查看语言代码code。

Previous图片翻译Next图片翻译结果数据查询API调用说明

Last updated