人体结构化属性PedestrianDetectAttribute的语法及示例_视觉智能开放平台(VIAPI)-阿里云帮助中心

功能描述

人体结构化属性能力可以检测图片中人体的属性，具体功能包括人体检测以及属性预估。例如：性别、年龄、朝向、帽子、眼镜、包、衣服、颜色等。

说明

您可以进入在线咨询获取在线人工帮助。
当前能力可在视觉智能开放平台有完整的免费产品体验，您可以单击立即试用对该能力进行更直观试用以及在线购买。
阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。

特色优势

丰富属性：提供丰富人体属性，包括年龄、性别、是否带眼镜、有无帽子、有无背包、有无手提包、有无肩挎包、上衣颜色、上衣种类、下衣颜色、下衣种类、人体朝向等。

接入指引

1. 注册阿里云账号：打开阿里云官网，在阿里云官网右上角，单击立即注册，按照操作提示完成账号注册。

2. 开通能力：请确保您已开通人脸人体服务，若未开通服务请立即开通。

说明本能力支持企业或个人认证用户开通。更多实名认证操作信息，请参见实名认证。

3. 创建AccessKey：请确保您已创建AccessKey，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见RAM授权。

4. 在线调试（可选）：您可以通过OpenAPI Explorer在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。

5. 开发接入步骤：

在SDK总览中选择您要接入使用的SDK语言。
在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。
参考文档中提供的示例代码进行适当修改后调用。

6. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。

输入限制

图像格式：JPG、JPEG、PNG、BMP。
图像大小：不大于3 MB。
图像分辨率：大于20×20像素，小于2048×2048像素。
URL地址中不能包含中文字符。

说明当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见图片缩放。

计费说明

关于人体结构化属性的计费方式及报价，请参见计费介绍。

说明下方调试接口为付费接口，如需免费体验调试请前往体验中心。

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	PedestrianDetectAttribute	系统规定参数。取值：PedestrianDetectAttribute。
ImageURL	String	是	http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/PedestrianDetectAttribute/PedestrianDetectAttribute1.jpg	图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见文件URL处理。

返回数据

名称	类型	示例值	描述
RequestId	String	4F609A30-F645-481E-A513-CADAA14DFB0A	请求ID。
Data	Object		返回的结果数据内容。
Attributes	Array of Attributes		行人属性。
Gender	Object		性别。
Score	Float	0.97989875078201294	置信度。
Name	String	female	male（男）；female（女）。
Orient	Object		人体朝向。
Score	Float	0.97838658094406128	置信度。
Name	String	Front	Front（正向）；Side（侧向）；Back（背面）。
Age	Object		年龄。
Score	Float	0.99590516090393066	置信度。
Name	String	Age18-60	AgeOver60（大于60岁）；Age18-60（18-60岁之间）；AgeLess18（小于18岁）。
UpperWear	Object		上衣种类。
Score	Float	0.89291918277740479	置信度。
Name	String	ShortSleeve	LongSleeve（长袖）；ShortSleeve（短袖）。
Glasses	Object		眼镜。
Score	Float	0.87284471094608307	置信度。
Name	String	No	Yes（戴眼镜）；No（不戴眼镜）。
LowerWear	Object		下衣种类。
Score	Float	0.6424860954284668	置信度。
Name	String	Trousers	Trousers（长裤）；Shorts（短裤）；Skirt&Dress（裙子）。
LowerColor	Object		下衣颜色。
Score	Float	0.69961744546890259	置信度。
Name	String	黑	黑，灰，蓝，绿，白，紫，红，棕，黄，粉，不确定。
Hat	Object		帽子。
Score	Float	0.98272394016385078	置信度。
Name	String	No	Yes（戴帽子）；No（不戴帽子）。
Handbag	Object		手提包。
Score	Float	0.55011671781539917	置信度。
Name	String	Yes	Yes（有手提包）；No（无手提包）。
Backpack	Object		背包。
Score	Float	0.96486538648605347	置信度。
Name	String	No	Yes（有背包）；No（无背包）。
UpperColor	Object		上衣颜色。
Score	Float	0.97796273231506348	置信度。
Name	String	黄	黑，灰，蓝，绿，白，紫，红，棕，黄，粉，不确定。
ShoulderBag	Object		肩挎包。
Score	Float	0.91198787838220596	置信度。
Name	String	No	Yes（有肩挎包）；No（无肩挎包）。
Boxes	Array of Boxes		检测到行人边界框的坐标。
BottomRightX	Float	584	边框右下角x坐标值。
TopLeftY	Float	27	边框左上角y坐标值。
Score	Float	0.88381063938140869	边界框置信度。
TopLeftX	Float	36	边框左上角x坐标值。
BottomRightY	Float	218	边框右下角y坐标值。
PersonNumber	Integer	1	检测到的行人个数，取值为正整数。
Width	Long	264	原图的宽度，单位像素。
Height	Long	584	原图的高度，单位像素。

SDK参考

阿里云视觉AI人脸人体类目下的人体结构化属性能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见SDK总览。

示例

请求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=PedestrianDetectAttribute  //更多关于访问域名（Endpoint）信息，请参见：https://help.aliyun.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/PedestrianDetectAttribute/PedestrianDetectAttribute1.jpg
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>4F609A30-F645-481E-A513-CADAA14DFB0A</RequestId>
<Data>
    <PersonNumber>1</PersonNumber>
    <Attributes>
        <Backpack>
            <Score>0.96486538648605347</Score>
            <Name>No</Name>
        </Backpack>
        <LowerWear>
            <Score>0.6424860954284668</Score>
            <Name>Trousers</Name>
        </LowerWear>
        <Orient>
            <Score>0.97838658094406128</Score>
            <Name>Front</Name>
        </Orient>
        <ShoulderBag>
            <Score>0.91198787838220596</Score>
            <Name>No</Name>
        </ShoulderBag>
        <LowerColor>
            <Score>0.69961744546890259</Score>
            <Name>黑</Name>
        </LowerColor>
        <Glasses>
            <Score>0.87284471094608307</Score>
            <Name>No</Name>
        </Glasses>
        <UpperColor>
            <Score>0.97796273231506348</Score>
            <Name>黄</Name>
        </UpperColor>
        <Handbag>
            <Score>0.55011671781539917</Score>
            <Name>Yes</Name>
        </Handbag>
        <Hat>
            <Score>0.98272394016385078</Score>
            <Name>No</Name>
        </Hat>
        <Gender>
            <Score>0.97989875078201294</Score>
            <Name>female</Name>
        </Gender>
        <Age>
            <Score>0.99590516090393066</Score>
            <Name>Age18-60</Name>
        </Age>
        <UpperWear>
            <Score>0.89291918277740479</Score>
            <Name>ShortSleeve</Name>
        </UpperWear>
    </Attributes>
    <Boxes>
        <BottomRightX>584</BottomRightX>
        <Score>0.88381063938140869</Score>
        <BottomRightY>218</BottomRightY>
        <TopLeftY>27</TopLeftY>
        <TopLeftX>36</TopLeftX>
    </Boxes>
</Data>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "4F609A30-F645-481E-A513-CADAA14DFB0A",
  "Data" : {
    "PersonNumber" : 1,
    "Attributes" : [ {
      "Backpack" : {
        "Score" : 0.9648653864860535,
        "Name" : "No"
      },
      "LowerWear" : {
        "Score" : 0.6424860954284668,
        "Name" : "Trousers"
      },
      "Orient" : {
        "Score" : 0.9783865809440613,
        "Name" : "Front"
      },
      "ShoulderBag" : {
        "Score" : 0.911987878382206,
        "Name" : "No"
      },
      "LowerColor" : {
        "Score" : 0.6996174454689026,
        "Name" : "黑"
      },
      "Glasses" : {
        "Score" : 0.8728447109460831,
        "Name" : "No"
      },
      "UpperColor" : {
        "Score" : 0.9779627323150635,
        "Name" : "黄"
      },
      "Handbag" : {
        "Score" : 0.5501167178153992,
        "Name" : "Yes"
      },
      "Hat" : {
        "Score" : 0.9827239401638508,
        "Name" : "No"
      },
      "Gender" : {
        "Score" : 0.9798987507820129,
        "Name" : "female"
      },
      "Age" : {
        "Score" : 0.9959051609039307,
        "Name" : "Age18-60"
      },
      "UpperWear" : {
        "Score" : 0.8929191827774048,
        "Name" : "ShortSleeve"
      }
    } ],
    "Boxes" : [ {
      "BottomRightX" : 584,
      "Score" : 0.8838106393814087,
      "BottomRightY" : 218,
      "TopLeftY" : 27,
      "TopLeftX" : 36
    } ]
  }
}

错误码

关于人体结构化属性的错误码，详情请参见常见错误码。

安全声明

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