本文介绍元素识别DetectImageElements的语法及示例。

功能描述

DetectImageElements用于识别输入图像中所包含的元素内容,用矩形框标注出其位置,并区分其对应的基本类型(人物、修饰、文案)。

示意图如下:

  • 输入 :
  • 输出 :

前提条件

请确保您已开通图像识别服务,详情请参见服务开通

调试

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

请求参数

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

要执行的操作。取值:DetectImageElements。

Url String https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/DetectImageElements/detect-elements-src.png

图片URL地址。URL地址中不能包含中文字符。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

Elements Array

元素列表。

Height Integer 354

元素高度。

Score Float 0.997097373008728

预测分值[0.0, 1.0]

Type String majorhuman

元素类型。包括:

UnType(未定义类型)、AllType(所有类型)、RootType(跟类型)、Synthesis(组合元素图)、Embedded(所有嵌套类型)、Format(元素格式)、MajorObject(主体)、Character(文案)、Identifier(标识)、Background(背景)、Decoration(修饰)、MajorHuman(人物模特)、MajorAuction(商品)、MajorThing(物体)、MajorOther(其他主体)、CharMain(主文案)、CharSub(副文案)、CharAction(行动点文案)、CharContent(内容文案)、CharNumber(数字文案)、CharOther(其他文案)、IdentLogo(logo标识)、IdentLight(高亮标识)、IdentCode(码标识)、IdentOther(其他标识)、BackBitmap(位图背景)、BackVector(矢量图背景)、BackOther(其他背景)、DecoTile(平铺修饰)、DecoRegion(区域修饰)、DecoPieces(碎片修饰)、DecoEdge(贴边修饰)、DecoLine(线性修饰)、DecoBox(框型修饰)、DecoChar(行动点文案修饰)、DecoOther(其他修饰)、SynthMajor(主体组团)、SynthChar(文案组团)、SynthIdent(标识组团)、SynthBack(背景组团)、SynthDeco(修饰组团)、SynthOther(其他组团)、EmbedSvg(svg嵌套格式)、EmbedJson(JSON嵌套格式)、EmbedHtml(html嵌套格式)。

Width Integer 285

元素宽度。

X Integer 287

元素左上角x坐标。

Y Integer 78

元素左上角y坐标。

RequestId String 2F04371B-CC88-4F3D-B84F-8B45903F7BAE

请求ID。

示例

请求示例

http(s)://imagerecog.cn-shanghai.aliyuncs.com/?Action=DetectImageElements
&Url=https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/DetectImageElements/detect-elements-src.png
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>2F04371B-CC88-4F3D-B84F-8B45903F7BAE</RequestId>
<Data>
    <Elements>
        <Type>majorhuman</Type>
        <Score>0.997097373008728</Score>
        <X>287</X>
        <Y>78</Y>
        <Height>354</Height>
        <Width>285</Width>
    </Elements>
</Data>

JSON 格式

{
	"RequestId": "2F04371B-CC88-4F3D-B84F-8B45903F7BAE",
	"Data": {
		"Elements": [
			{
				"Type": "majorhuman",
				"Score": "0.997097373008728",
				"X": 287,
				"Y": 78,
				"Height": 354,
				"Width": 285
			}
		]
	}
}

错误码

关于元素识别的错误码,详情请参见常见错误码