图片翻译编辑器协议

更新时间:
复制 MD 格式

本文说明图片翻译编辑器协议,即图片翻译 Pro 版开启 UseImageEditor=true 时返回的 Data.GenFiles 结构。该结构包含原图、识别出的文本框、译文及其位置、字体、颜色、图层等信息,供二次编辑与接入图片编辑器使用,并被图片翻译 Pro 版同步/异步响应等多处统一引用。当前编辑器功能尚未正式上线,您可以基于此文档了解出参信息,后续平台发布编辑器产品后会在此文档进行更新。

概述

  • 何时返回:仅当请求参数 UseImageEditor=true 时返回。图片翻译 Pro 版同步模式在响应 Data.GenFiles 中直接返回;异步模式在查询接口 Status=COMPLETED 时于 Data.GenFiles 返回。

  • 结构GenFiles 为数组,每个元素对应一张原图,包含三个平级字段——SrcImage(原图)、EditInfo(编辑器详细信息)、ResultList(该原图的翻译结果)。

  • 二次编辑:可解析 EditInfo.TextAreas 中的文本与坐标,修改 texts.value(译文)等字段后,再调用合图相关接口重新生成图片。

字段说明

字段

类型

说明

Data.GenFiles

Array[Object]

编辑器协议数组(仅 UseImageEditor=true 时返回);每个元素对应一张原图,含下列字段。

GenFiles[].SrcImage

String

原图 URL。

GenFiles[].EditInfo

Object

原图编辑器信息。

GenFiles[].EditInfo.ResultImageIds

Array[String]

翻译后图片全局 Id 集合。

GenFiles[].EditInfo.RepairedUrl

String

所有文字涂抹后的图片 URL(干净底图)。

GenFiles[].EditInfo.Languages

Array[String]

翻译语种。

GenFiles[].EditInfo.TextAreas

Array[Object]

文本框列表。

GenFiles[].EditInfo.TextAreas[].Fontsize

Number

字体大小。

GenFiles[].EditInfo.TextAreas[].Content

String

翻译前的文本(原文)。

GenFiles[].EditInfo.TextAreas[].Color

String

文字颜色,如 #ffffff。

GenFiles[].EditInfo.TextAreas[].VerticalLayout

String

垂直对齐:center / top / down。

GenFiles[].EditInfo.TextAreas[].LineCount

Number

文本框行数。

GenFiles[].EditInfo.TextAreas[].HorizontalLayout

String

水平对齐:center / left / right。

GenFiles[].EditInfo.TextAreas[].Texts

Array[Object]

译文文本列表。

GenFiles[].EditInfo.TextAreas[].Texts[].Fontsize

Number

字体大小。

GenFiles[].EditInfo.TextAreas[].Texts[].Language

String

语言。

GenFiles[].EditInfo.TextAreas[].Texts[].Valid

Boolean

文本条目是否有效;缺省或 false 视为无效。

GenFiles[].EditInfo.TextAreas[].Texts[].ImageRect

Object

图片修复区域。

GenFiles[].EditInfo.TextAreas[].Texts[].ImageRect.Height

Number

GenFiles[].EditInfo.TextAreas[].Texts[].ImageRect.Left

Number

GenFiles[].EditInfo.TextAreas[].Texts[].ImageRect.Top

Number

GenFiles[].EditInfo.TextAreas[].Texts[].ImageRect.Width

Number

GenFiles[].EditInfo.TextAreas[].Texts[].ImageRect.Degree

Number

文本框旋转角(角度制),<1 视为水平文本框。

GenFiles[].EditInfo.TextAreas[].Texts[].TextRect

Object

文本框区域。

GenFiles[].EditInfo.TextAreas[].Texts[].TextRect.Height

Number

高。

GenFiles[].EditInfo.TextAreas[].Texts[].TextRect.Left

Number

左。

GenFiles[].EditInfo.TextAreas[].Texts[].TextRect.Top

Number

上。

GenFiles[].EditInfo.TextAreas[].Texts[].TextRect.Width

Number

宽。

GenFiles[].EditInfo.TextAreas[].Texts[].TextRect.Degree

Number

文本框旋转角(角度制),<1 视为水平文本框。

GenFiles[].EditInfo.TextAreas[].Texts[].Color

String

颜色。

GenFiles[].EditInfo.TextAreas[].Texts[].Value

String

翻译后文本(译文)。

GenFiles[].EditInfo.TextAreas[].Texts[].VerticalLayout

String

垂直对齐:center / top / down。

GenFiles[].EditInfo.TextAreas[].Texts[].OvisErrMsg

String

ovis 模型报错信息及执行时间,如 | ovis time: 0.748。

GenFiles[].EditInfo.TextAreas[].Texts[].LineCount

Number

文本框行数。

GenFiles[].EditInfo.TextAreas[].Texts[].HorizontalLayout

String

水平对齐:center / left / right。

GenFiles[].EditInfo.GoodsRects

Object

商品框区域。

GenFiles[].EditInfo.GoodsRects.Height

Number

高。

GenFiles[].EditInfo.GoodsRects.Left

Number

左。

GenFiles[].EditInfo.GoodsRects.Top

Number

上。

GenFiles[].EditInfo.GoodsRects.Width

Number

宽。

GenFiles[].EditInfo.GoodsRects.Degree

Number

旋转角(角度制),<1 视为水平。

GenFiles[].EditInfo.Font

Array[String]

字体类型。

GenFiles[].ResultList

Array[Object]

该原图对应的翻译结果集合。

GenFiles[].ResultList[].Language

String

翻译语种。

GenFiles[].ResultList[].FileUrl

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" }
    ]
  }
]