本文介绍人体检测DetectPedestrian的语法及示例。
功能描述
人体检测可以检测图像中的所有人体,并返回每个人体的矩形框位置。

应用场景
- 记录有人视频:在摄像头录像中,通过人体检测,可以过滤无人的视频段,仅保留有人员出现的视频,减少视频存储量。
- 人流统计:结合多帧人体检测结果,进行过线判断,可以运用于商场、景区、交通枢纽的人流量统计。
- 在岗检测:检测固定工作岗位上是否有人员在岗。
- 智能办公室:检测办公室内是否有人,智能控制照明灯或空调的开关,节约能源,绿色环保。
特色优势
- 支持多角度检测:针对正面,侧面,高角度等拍摄的图像,都可以准确检测出人脸。
- 抗遮挡能力强:对于人体被少部分遮挡的场景,仍可以准确检测出人体。
前提条件
计费说明
关于人体检测的计费方式及报价,请参见计费介绍。
输入限制
- 图片格式:JPEG、JPG、PNG、BMP。
- 图片大小:图片大小不超过3M。
- URL地址中不能包含中文字符。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DetectPedestrian |
要执行的操作。取值:DetectPedestrian。 |
ImageURL | String | 是 | https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/detectperson.jpg |
图片URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data | Struct |
返回的数据内容。 |
|
Elements | Array of Element |
人体检测框的集合。 |
|
Boxes | List | [326, 293, 500, 546 ] |
检测框坐标,格式为 |
Score | Float | 0.999 |
检测框的置信度,取值范围为0~1。 |
Type | String | person |
检测框对应的检测结果类型。仅返回参数值 |
Height | Integer | 599 |
输入图片的高度。 |
Width | Integer | 899 |
输入图片的宽度。 |
RequestId | String | 45DBA494-6250-42C4-80D1-7CF19BDD2CB1 |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DetectPedestrian
&ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/detectperson.jpg
&<公共请求参数>
正常返回示例
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
格式
{
"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
}
}
错误码
关于人体检测的错误码 ,详情请参见常见错误码。
SDK参考
阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。
在文档使用中是否遇到以下问题
更多建议
匿名提交