将图片上的文字从一种语言翻译成另一种语言，并输出一张新图片。

请确保在使用该接口前，已充分了解图片翻译产品的收费方式和价格。

该接口适用于通用图片翻译和电商图片翻译。

如需调用证件翻译，请参考这里。

图片限制
  • 文件大小限制：10M
  • 像素限制：长宽比 < 10：1
  • 支持的格式：jpg, jpeg, png, bmp, gif（仅翻译第一帧）, webp

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 TranslateImage

系统规定参数。取值：TranslateImage。

说明 仅支持通过POST方式调用
ImageUrl String 否 https://example.com/example.jpg

原图 URL，跟 Base64 不能同时为空，优先取 Base64。
ImageBase64 String 否 /9j/4...H/9k=

原图 Base64，跟 URL 不能同时为空，优先取 Base64。
SourceLanguage String 否 zh

源语种，支持的语种参考，必填（请忽略表格中“是否必填”中的“否”）
TargetLanguage String 否 en

目标语种，支持的语种参考，必填（请忽略表格中“是否必填”中的“否”）
Field String 否 general

翻译领域， 可选值如下。

  • general: 通用图片翻译
  • e-commerce: 电商领域图片翻译

默认及未识别领域均按通用图片翻译处理。
Ext String 否 {"needEditorData": "false", "ignoreEntityRecognize": "true"}

扩展信息, JSON String 格式，里面可以包含的字段如下。

  • needEditorData: 取值为字符串 true/false，默认为false，是否需要在结果中返回图片翻译译后编辑器数据，仅用于自行接入图片翻译译后编辑器时，获取数据使用
  • ignoreEntityRecognize：取值为字符串 true/false，默认为 false，电商领域图片翻译会自动判断文字是否在图片中的商品主体上，如果在，则略过翻译；使用本字段来控制是否进行上述判断，本字段对通用图片翻译无效

返回数据

名称 类型 示例值 描述
RequestId String D774D33D-F1CB-5A2C-A787-E0A2179239CE

请求标识
Code Integer 200

请求结果状态码
Message String Error Message

请求错误信息
Data Object

图片翻译结果结构体
InPaintingUrl String https://example.com/example.jpg

图片译后编辑器背景图
TemplateJson String Editor Template Json String

图片译后编辑器模版数据
FinalImageUrl String https://example.com/example.jpg

最终翻译结果图片 URL

示例

请求示例

http(s)://[Endpoint]/?Action=TranslateImage
&SourceLanguage=zh
&TargetLanguage=en
&Field=general
&Ext={"needEditorData", "true"}
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<TranslateImageResponse>
    <code>200</code>
    <data>
        <finalImageUrl>https://example.com/example.jpg</finalImageUrl>
    </data>
    <requestId>D774D33D-F1CB-5A2C-A787-E0A2179239CE</requestId>
</TranslateImageResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "code" : 200,
  "data" : {
    "finalImageUrl" : "https://example.com/example.jpg"
  },
  "requestId" : "D774D33D-F1CB-5A2C-A787-E0A2179239CE"
}

错误码

HttpCode 错误码 错误信息 描述
400 Parameter.SourceLangError Source languages are not supported. 源语种不支持。
400 Parameter.TargetLangError Target languages are not supported. 目标语种不支持。
401 System.subNotPermission The sub-account is not authorized to perform the operation. 子账号没有权限
401 System.AccountNotActivated The account has not activated the service. 账号没有开通服务
406 System.ParameterError Some required parameters are missing. 参数错误
406 Parameter.ImageUrlError Failed to obtain the image from the URL. 从URL下载图片失败
406 Parameter.ImageSizeError Image size should be within 15px to 8192px. 图片尺寸超出限制，需在15px到8192px之间
406 Parameter.ImageFormatError The image format is not supported. 图片格式不支持
406 Parameter.ImageFileSizeError The image file size should be within 10 MB. 图片大小超出限制，需在10MB以内
500 System.unknownError An unknown error occurred. 未知错误
500 ImageTranslate.TranslationError Image translation error. 图片翻译错误
500 ImageTranslate.FusionError Image fusion error. 合图错误
500 ImageTranslate.EraseError Image erasing error. 擦图错误
500 ImageTranslate.TextTranslationError Text translation error. 文本翻译错误
500 ImageTranslate.TextToParagraphError Text to paragraph error. 段落合并错误

访问错误中心查看更多错误码。