功能描述

人體檢測能力可以檢測圖像中的所有人體。主要適用于監(jiān)控場景，建議人體占圖片的比例小于1/2。產(chǎn)品支持以下功能：

• 人體檢測：返回圖像中人體矩形框位置，并輸出圖像中人體所在的坐標(biāo)位置。
• 人體信息：輸出圖像中人物置信度；可同時識別圖片中多個人體。

關(guān)于該接口功能的示例圖如下：

• 輸入原圖
• 輸出結(jié)果圖

應(yīng)用場景

• 記錄有人視頻：在攝像頭錄像中，通過人體檢測，可以過濾無人的視頻段，僅保留有人員出現(xiàn)的視頻，減少視頻存儲量。
• 人流統(tǒng)計：結(jié)合多幀人體檢測結(jié)果，進行過線判斷，可以運用于商場、景區(qū)、交通樞紐的人流量統(tǒng)計。
• 在崗檢測：檢測固定工作崗位上是否有人員在崗。
• 智能辦公室：檢測辦公室內(nèi)是否有人，智能控制照明燈或空調(diào)的開關(guān)，節(jié)約能源，綠色環(huán)保。

特色優(yōu)勢

• 支持多角度檢測：針對正面，側(cè)面，高角度等拍攝的圖像，都可以準(zhǔn)確檢測出人體。
• 抗遮擋能力強：對于人體被少部分遮擋的場景，仍可以準(zhǔn)確檢測出人體。

接入指引

1. 注冊阿里云賬號：打開阿里云官網(wǎng)，在阿里云官網(wǎng)右上角，單擊立即注冊，按照操作提示完成賬號注冊。

2. 開通能力：請確保您已開通人臉人體服務(wù)，若未開通服務(wù)請立即開通。

3. 創(chuàng)建AccessKey：請確保您已創(chuàng)建AccessKey，如果您使用的是子賬號AccessKey，您需要給子賬號賦予AliyunVIAPIFullAccess權(quán)限，具體操作，請參見RAM授權(quán)。

4. 在線調(diào)試（可選）：您可以通過OpenAPI Explorer在線調(diào)試能力，查看完整的調(diào)用示例代碼及SDK依賴信息，也可以下載完整的工程。

5. 開發(fā)接入步驟：

• 在SDK總覽中選擇您要接入使用的SDK語言。
• 在對應(yīng)語言的SDK文檔中找到AI類目為人臉人體（facebody）的SDK包進行安裝。
• 參考文檔中提供的示例代碼進行適當(dāng)修改后調(diào)用。

6. 示例代碼：該能力常用語言的示例代碼，請參見人體檢測示例代碼。

7. 客戶端直接調(diào)用：該能力常用的客戶端調(diào)用方式包括以下幾種。

• Web前端直接調(diào)用
• 小程序場景下直接調(diào)用
• Android端直接調(diào)用
• iOS端直接調(diào)用

輸入限制

• 圖像格式：JPEG、JPG、PNG、BMP。
• 圖像大小：不超過3 MB。
• 圖像分辨率：分辨率大于32×32像素， 分辨率小于2000×2000像素，最長邊小于2000像素，人臉占比不低于64×64像素。
• URL地址中不能包含中文字符。

計費說明

關(guān)于人體檢測的計費方式及報價，請參見計費介紹。

請求參數(shù)

返回數(shù)據(jù)

SDK參考

阿里云視覺AI人臉人體類目下的人體檢測能力推薦使用SDK調(diào)用，支持多種編程語言，調(diào)用時請選擇AI類目為人臉人體（facebody）的SDK包，文件參數(shù)通過SDK調(diào)用可支持本地文件及任意URL，具體可參見SDK總覽。

示例代碼

該能力常用語言的示例代碼，請參見人體檢測示例代碼。

示例

請求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=DetectPedestrian   //更多關(guān)于訪問域名（Endpoint）信息，請參見：http://m.bestwisewords.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectPedestrian/DetectPedestrian8.jpg
&公共請求參數(shù)

正常返回示例

XML格式

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

<RequestId>45DBA494-6250-42C4-80D1-7CF19BDD2CB1</RequestId>
<Data>
    <Height>599</Height>
    <Elements>
        <Score>0.999</Score>
        <Type>person</Type>
        <Boxes>326</Boxes>
        <Boxes>293</Boxes>
        <Boxes>500</Boxes>
        <Boxes>546</Boxes>
    </Elements>
    <Elements>
        <Score>0.998</Score>
        <Type>person</Type>
        <Boxes>181</Boxes>
        <Boxes>156</Boxes>
        <Boxes>425</Boxes>
        <Boxes>534</Boxes>
    </Elements>
    <Elements>
        <Score>0.993</Score>
        <Type>person</Type>
        <Boxes>515</Boxes>
        <Boxes>300</Boxes>
        <Boxes>705</Boxes>
        <Boxes>549</Boxes>
    </Elements>
    <Elements>
        <Score>0.986</Score>
        <Type>person</Type>
        <Boxes>661</Boxes>
        <Boxes>129</Boxes>
        <Boxes>797</Boxes>
        <Boxes>506</Boxes>
    </Elements>
    <Elements>
        <Score>0.959</Score>
        <Type>person</Type>
        <Boxes>511</Boxes>
        <Boxes>271</Boxes>
        <Boxes>572</Boxes>
        <Boxes>451</Boxes>
    </Elements>
    <Width>899</Width>
</Data>

JSON格式

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

{
  "RequestId" : "45DBA494-6250-42C4-80D1-7CF19BDD2CB1",
  "Data" : {
    "Height" : 599,
    "Elements" : [ {
      "Score" : 0.999,
      "Type" : "person",
      "Boxes" : [ 326, 293, 500, 546 ]
    }, {
      "Score" : 0.998,
      "Type" : "person",
      "Boxes" : [ 181, 156, 425, 534 ]
    }, {
      "Score" : 0.993,
      "Type" : "person",
      "Boxes" : [ 515, 300, 705, 549 ]
    }, {
      "Score" : 0.986,
      "Type" : "person",
      "Boxes" : [ 661, 129, 797, 506 ]
    }, {
      "Score" : 0.959,
      "Type" : "person",
      "Boxes" : [ 511, 271, 572, 451 ]
    } ],
    "Width" : 899
  }
}

錯誤碼

關(guān)于人體檢測的錯誤碼 ，詳情請參見常見錯誤碼。

開源模型體驗

更多開源免費模型體驗及下載，詳見魔搭社區(qū)：人體檢測-通用-Base和實時人體檢測-通用。

安全聲明

• 請確保上傳的圖片或文件來源符合相應(yīng)的法律法規(guī)。
• 通過體驗調(diào)試上傳的臨時文件有效期為1小時，在24小時后會被系統(tǒng)自動清理刪除。