图片翻译API 调用说明

图片翻译

GET/POST /ai/image/translation

产品描述

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

请求参数

参数名称	类型	必填	参数描述及示例值
imageUrl	String	是	图片要求：不超过 4000x4000像素；大小不超过 10MB； 支持png、jpeg、jpg、bmp、webp。 示例值：http://example.jpg/
sourceLanguage	String	是	源语言代码；支持的语向见附录的支持语向列表。 示例值："en"
targetLanguage	String	是	目标语言代码；支持的语向见附录的支持语向列表。 示例值："ko"
translatingTextInTheProduct	Boolean	否	选择是否翻译图片主体上文字； 这可以帮助您保护信息，避免翻译诸如商品名称等嵌入信息。 如示例图中，红框中的文本代表主体上文字，蓝框中的文本代表非主体上文字。 示例值："false"
useImageEditor	Boolean	否	是否返回文字的位置、字体、颜色等布局信息。可用于二次编辑接入图片编辑器时获取数据使用。在获取返回的ID后，您可再调用图片翻译结果数据查询接口获取完整参数信息 示例值："false"

请求示例

Java

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	报错信息，例如“内容包含敏感数据，请尝试其他输入”。

响应示例

Java

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