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

功能描述

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

示意图如下:

  • 输入 :
  • 输出 :

前提条件

请确保您已开通图像识别服务,若未开通服务请立即开通

输入限制

  • 图片格式:JPG、JPEG、BMP、PNG。
  • 图片大小:大小不超过3M。
  • 图片分辨率:分辨率大小不超过1280×1280。
  • URL地址中不能包含中文字符。

调试

您可以在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地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

Elements Array of Element

元素列表。

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

错误码

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

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。