本文档介绍人体结构化属性PedestrianDetectAttribute的语法及示例。

功能描述

PedestrianDetectAttribute可以检测图片中人体的属性,具体功能包括人体检测以及属性预估。例如:性别,年龄,朝向,帽子,眼镜,包,衣服,颜色等。

前提条件

请确保您已开通人脸人体服务,若未开通服务请立即开通

输入限制

  • 图片格式:JPG、JPEG、PNG、BMP。
  • 图片像素:大于20×20像素,无上限要求,但是太大可能会下载超时。
  • URL地址中不能包含中文字符。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
ImageURL String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xuhan/%E5%85%A8%E8%BA%AB%E7%85%A7.png

图片URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

Attributes Array of Attributes

行人属性。

Age Struct

年龄。

Name String Age18-60

AgeOver60(大于60岁);Age18-60(18-60岁之间);AgeLess18(小于18岁)。

Score Float 0.99590516090393066

置信度。

Backpack Struct

背包。

Name String No

Yes(有背包);No(无背包)。

Score Float 0.96486538648605347

置信度。

Gender Struct

性别。

Name String female

male(男);female(女)。

Score Float 0.97989875078201294

置信度。

Glasses Struct

眼镜。

Name String No

Yes(戴眼镜);No(不戴眼镜)。

Score Float 0.87284471094608307

置信度。

Handbag Struct

手提包。

Name String Yes

Yes(有手提包);No(无手提包)。

Score Float 0.55011671781539917

置信度。

Hat Struct

帽子。

Name String No

Yes(戴帽子);No(不戴帽子)。

Score Float 0.98272394016385078

置信度。

LowerColor Struct

下衣颜色。

Name String

黑,灰,蓝,绿,白,紫,红,棕,黄,粉,不确定。

Score Float 0.69961744546890259

置信度。

LowerWear Struct

下衣种类。

Name String Trousers

Trousers(长裤);Shorts(短裤);Skirt&Dress(裙子)。

Score Float 0.6424860954284668

置信度。

Orient Struct

人体朝向。

Name String Front

Front(正向);Side(侧向);Back(背面)。

Score Float 0.97838658094406128

置信度。

ShoulderBag Struct

肩挎包。

Name String No

Yes(有肩挎包);No(无肩挎包)。

Score Float 0.91198787838220596

置信度。

UpperColor Struct

上衣颜色。

Name String

黑,灰,蓝,绿,白,紫,红,棕,黄,粉,不确定。

Score Float 0.97796273231506348

置信度。

UpperWear Struct

上衣种类。

Name String ShortSleeve

LongSleeve(长袖);ShortSleeve(短袖)。

Score Float 0.89291918277740479

置信度。

Boxes Array of Boxes

检测到行人边界框的坐标。

BottomRightX Float 584

边框右下角x坐标值。

BottomRightY Float 218

边框右下角y坐标值。

Score Float 0.88381063938140869

边界框置信度。

TopLeftX Float 36

边框左上角x坐标值。

TopLeftY Float 27

边框左上角y坐标值。

PersonNumber Integer 1

检测到的行人个数,取值为正整数。

RequestId String 4F609A30-F645-481E-A513-CADAA14DFB0A

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=PedestrianDetectAttribute
&ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xuhan/%E5%85%A8%E8%BA%AB%E7%85%A7.png
&<公共请求参数>

正常返回示例

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 格式

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

错误码

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

SDK参考

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

安全声明

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