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

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

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

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

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

调试

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

请求参数

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

系统规定参数。取值:TranslateImage

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 错误码 错误信息 描述
401 System.AccountNotActivated The account has not activated the service. 账号没有开通服务

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