本文介紹人臉人體(facebody)類目下的人體結構化屬性PedestrianDetectAttribute的語法及示例。
功能描述
人體結構化屬性能力可以檢測圖片中人體的屬性,具體功能包括人體檢測以及屬性預估。例如:性別、年齡、朝向、帽子、眼鏡、包、衣服、顏色等。
特色優勢
豐富屬性:提供豐富人體屬性,包括年齡、性別、是否帶眼鏡、有無帽子、有無背包、有無手提包、有無肩挎包、上衣顏色、上衣種類、下衣顏色、下衣種類、人體朝向等。
接入指引
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)信息,請參見:http://bestwisewords.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小時后會被系統自動清理刪除。