图片翻译编辑器协议
本文说明图片翻译编辑器协议,即图片翻译 Pro 版开启 UseImageEditor=true 时返回的 Data.GenFiles 结构。该结构包含原图、识别出的文本框、译文及其位置、字体、颜色、图层等信息,供二次编辑与接入图片编辑器使用,并被图片翻译 Pro 版同步/异步响应等多处统一引用。当前编辑器功能尚未正式上线,您可以基于此文档了解出参信息,后续平台发布编辑器产品后会在此文档进行更新。
概述
何时返回:仅当请求参数
UseImageEditor=true时返回。图片翻译 Pro 版同步模式在响应Data.GenFiles中直接返回;异步模式在查询接口Status=COMPLETED时于Data.GenFiles返回。结构:
GenFiles为数组,每个元素对应一张原图,包含三个平级字段——SrcImage(原图)、EditInfo(编辑器详细信息)、ResultList(该原图的翻译结果)。二次编辑:可解析
EditInfo.TextAreas中的文本与坐标,修改texts.value(译文)等字段后,再调用合图相关接口重新生成图片。
字段说明
字段 | 类型 | 说明 |
| Array[Object] | 编辑器协议数组(仅 UseImageEditor=true 时返回);每个元素对应一张原图,含下列字段。 |
| String | 原图 URL。 |
| Object | 原图编辑器信息。 |
| Array[String] | 翻译后图片全局 Id 集合。 |
| String | 所有文字涂抹后的图片 URL(干净底图)。 |
| Array[String] | 翻译语种。 |
| Array[Object] | 文本框列表。 |
| Number | 字体大小。 |
| String | 翻译前的文本(原文)。 |
| String | 文字颜色,如 #ffffff。 |
| String | 垂直对齐:center / top / down。 |
| Number | 文本框行数。 |
| String | 水平对齐:center / left / right。 |
| Array[Object] | 译文文本列表。 |
| Number | 字体大小。 |
| String | 语言。 |
| Boolean | 文本条目是否有效;缺省或 false 视为无效。 |
| Object | 图片修复区域。 |
| Number | 高 |
| Number | 左 |
| Number | 上 |
| Number | 宽 |
| Number | 文本框旋转角(角度制),<1 视为水平文本框。 |
| Object | 文本框区域。 |
| Number | 高。 |
| Number | 左。 |
| Number | 上。 |
| Number | 宽。 |
| Number | 文本框旋转角(角度制),<1 视为水平文本框。 |
| String | 颜色。 |
| String | 翻译后文本(译文)。 |
| String | 垂直对齐:center / top / down。 |
| String | ovis 模型报错信息及执行时间,如 | ovis time: 0.748。 |
| Number | 文本框行数。 |
| String | 水平对齐:center / left / right。 |
| Object | 商品框区域。 |
| Number | 高。 |
| Number | 左。 |
| Number | 上。 |
| Number | 宽。 |
| Number | 旋转角(角度制),<1 视为水平。 |
| Array[String] | 字体类型。 |
| Array[Object] | 该原图对应的翻译结果集合。 |
| String | 翻译语种。 |
| String | 翻译后图片文件 URL。 |
结构示例
"GenFiles": [
{
"SrcImage": "https://img.alicdn.com/.../source.jpg",
"EditInfo": {
"ResultImageIds": ["0c39c8ae-5820-11f1-bbb2-8281b7a4eed1"],
"RepairedUrl": "http://dashscope-a717.oss-cn-beijing.aliyuncs.com/.../repaired.png",
"Languages": ["en"],
"TextAreas": [
{
"Fontsize": 32,
"Content": "萌趣造型·清脆响铃",
"Color": "#515151",
"VerticalLayout": "center",
"HorizontalLayout": "left",
"LineCount": 1,
"Texts": [
{
"Fontsize": 29,
"Language": "en",
"Valid": true,
"ImageRect": { "Height": 54, "Left": 43, "Top": 83, "Width": 418, "Degree": 0 },
"TextRect": { "Height": 30, "Left": 8, "Top": 95, "Width": 488, "Degree": 0 },
"Color": "#515151",
"Value": "Adorable Design · Crisp Bell Sound",
"VerticalLayout": "center",
"HorizontalLayout": "center",
"LineCount": 1,
"OvisErrMsg": "| ovis time: 0.748"
}
]
}
],
"GoodsRects": { "Height": 0, "Left": 0, "Top": 0, "Width": 0, "Degree": 0 },
"Font": ["AlibabaSans-Regular"]
},
"ResultList": [
{ "Language": "en", "FileUrl": "http://dashscope-a717.oss-cn-beijing.aliyuncs.com/.../result.jpg" }
]
}
]