TranslateImage - 图片翻译

更新时间: 2023-12-07 17:19:55

将图片上的文字从一种语言翻译成另一种语言,并输出一张尽可能忠于原图的新图片。

接口说明

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

该接口适用于通用图片翻译电商图片翻译。 如需调用证件翻译,请参考证件翻译调用指南

图片限制

  • 文件大小限制:10M
  • 像素限制:长宽比 < 10:1
  • 支持的格式:jpg, jpeg, png, bmp, gif(仅翻译第一帧), webp
说明 仅支持通过POST方式调用

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
alimt:TranslateImageWrite
  • 全部资源
    acs:alimt:*:{#accountid}:*

请求参数

名称类型必填描述示例值
ImageUrlstring

原图 URL,跟 Base64 不能同时为空,优先取 Base64。

https://example.com/example.jpg
ImageBase64string

原图 Base64,跟 URL 不能同时为空,优先取 Base64。

/9j/4...H/9k=
SourceLanguagestring

源语种,支持的语种参考,必填(请忽略表格中“是否必填”中的“否”)

zh
TargetLanguagestring

目标语种,支持的语种参考,必填(请忽略表格中“是否必填”中的“否”)

en
Fieldstring

翻译领域, 可选值如下。

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

默认及未识别领域均按通用图片翻译处理。

general
Extstring

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

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

返回参数

名称类型描述示例值
object

结果

RequestIdstring

请求标识

D774D33D-F1CB-5A2C-A787-E0A2179239CE
Codeinteger

请求结果状态码

200
Messagestring

请求错误信息

Error Message
Dataobject

图片翻译结果结构体

InPaintingUrlstring

图片译后编辑器背景图

https://example.com/example.jpg
TemplateJsonstring

图片译后编辑器模版数据

Editor Template Json String
FinalImageUrlstring

最终翻译结果图片 URL

https://example.com/example.jpg

示例

正常返回示例

JSON格式

{
  "RequestId": "D774D33D-F1CB-5A2C-A787-E0A2179239CE",
  "Code": 200,
  "Message": "Error Message",
  "Data": {
    "InPaintingUrl": "https://example.com/example.jpg",
    "TemplateJson": "Editor Template Json String",
    "FinalImageUrl": "https://example.com/example.jpg"
  }
}

错误码

HTTP status code错误码错误信息描述
400Parameter.SourceLangErrorSource languages are not supported.源语种不支持。
400Parameter.TargetLangErrorTarget languages are not supported.目标语种不支持。
401System.subNotPermissionThe sub-account is not authorized to perform the operation.子账号没有权限
401System.AccountNotActivatedThe account has not activated the service.账号没有开通服务
406System.ParameterErrorSome required parameters are missing.参数错误
406Parameter.ImageUrlErrorFailed to obtain the image from the URL.从URL下载图片失败
406Parameter.ImageSizeErrorImage size should be within 15px to 8192px.图片尺寸超出限制,需在15px到8192px之间
406Parameter.ImageFormatErrorThe image format is not supported.图片格式不支持
406Parameter.ImageFileSizeErrorThe image file size should be within 10 MB.图片大小超出限制,需在10MB以内
500System.unknownErrorAn unknown error occurred.未知错误
500ImageTranslate.TranslationErrorImage translation error.图片翻译错误
500ImageTranslate.FusionErrorImage fusion error.合图错误
500ImageTranslate.EraseErrorImage erasing error.擦图错误
500ImageTranslate.TextTranslationErrorText translation error.文本翻译错误
500ImageTranslate.TextToParagraphErrorText to paragraph error.段落合并错误

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

阿里云首页 机器翻译 相关技术圈