接口描述
对于输入的一张图片（可正常解码，且长宽比适宜），识别和统计图像当中的人体个数（静态统计，不支持追踪和去重）。
适用于3米以上的中远距离俯拍，以头部为主要识别目标统计人数，无需正脸、全身照，适应各类人流密集场景（如：机场、车展、景区、广场等）；默认识别整图中的人数，支持指定不规则区域的人数统计，同时可输出渲染图片。
摄像头硬件选型无特殊要求，分辨率建议720p以上，更低分辨率的图片也能识别，只是效果可能有差异。暂不适用夜间红外监控图片，后续会考虑扩展。
渲染图示意如下：
注：接口默认返回整张图片中的人数，如需统计特定框选区域的人数，请使用area参数添加识别区域坐标信息。
在线调试
您可以在 示例代码中心 中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
请求说明
请求示例
HTTP 方法：POST
请求URL： https://aip.baidubce.com/rest/2.0/image-classify/v1/body_num
URL参数：
| 参数 | 值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token，参考“Access Token获取” |
Header如下：
| 参数 | 值 |
|---|---|
| Content-Type | application/x-www-form-urlencoded |
Body中放置请求参数，参数详情如下：
请求参数
| 参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
|---|---|---|---|---|
| image | 是 | string | - | 图像数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M。图片的base64编码是不包含图片头的，如(data:image/jpg;base64,)，支持图片格式：jpg、bmp、png，最短边至少50px，最长边最大4096px |
| area | 否 | string | - |
特定框选区域坐标，支持多个多边形区域，最多支持10个区域，如输入超过10个区域，截取前10个区域进行识别。 此参数为空或无此参数、或area参数设置错误时，默认识别整个图片的人数 。 area参数设置错误的示例：某个坐标大于或等于原图大小，x、y坐标未成对出现等；注意：设置了多个区域时，任意一个坐标设置错误，则认为area参数错误、失效。 area参数设置格式： 1）多个区域用英文分号“;”分隔； 2）同一个区域内的坐标用英文逗号“,”分隔，默认尾点和首点相连做闭合。 示例： 1）单个多边形区域：x1,y1,x2,y2,x3,y3...xn,yn 2）多个多边形区域：xa1,ya1,xa2,ya2,xa3,ya3...xan,yan;xb1,yb1,xb2,yb2,xb3,yb3...xbn,ybn;...注意：area区域坐标需要从（1，1）开始，（0，0）属于图片边界之外 |
| show | 否 | string | true,false | 是否输出渲染的图片，默认不返回，选true时返回渲染后的图片(base64)，其它无效值或为空则默认false |
请求代码示例
提示一：使用示例代码前，请记得替换其中的示例Token、图片地址或Base64信息。
提示二：部分语言依赖的类或库，请在代码注释中查看下载地址。
人流量统计 curl -i -k 'https://aip.baidubce.com/rest/2.0/image-classify/v1
/body_num?access_token=【调用鉴权接口获取的token】' --data 'image=【图片Base64编码，
需UrlEncode】' -H 'Content-Type:application/x-www-form-urlencoded'
返回说明
返回参数
| 字段 | 是否必选 | 类型 | |
|---|---|---|---|
| person_num | 是 | uint64 | 识别出的人体数目；当未设置area参数时，返回的是全图人数；设置了有效的area参数时，返回的人数是所有区域的人数总和（所有区域求并集后的不规则区域覆盖的人数） |
| image | 否 | string | 渲染后的图片，输入参数show=true时输出该字段 |
| area_counts | 否 | array | 每一个框选区域的人数，仅当请求中有area参数且参数有效时才会返回，否则该字段不返回；成功返回示例：[5,3,8] |
返回示例
{
"log_id": 716033439,
"person_num": 16,
"image": "/9j/4AAoFS2P/9k="
}
