Hi，您好，欢迎使用百度人体分析在线API服务。
本文档主要针对API开发者，描述百度人体分析接口服务的相关技术内容。如果您对文档内容有任何疑问，可以通过以下几种方式联系我们：
- 在百度云控制台内提交工单，咨询问题类型请选择人工智能服务
- 进入AI社区交流：http://ai.baidu.com/forum/topic/list/197
- 具有免费调用额度的接口，超过每天的免费额度后会返回错误码：17，错误信息：Open api daily request limit reached（每天调用量超出限额），未上线计费功能的接口，可通过QQ群（860337848）联系群管、或提交工单申请提额
- 各个接口的免费调用额度（调用量和QPS并发），以及产品价格说明，请参考产品价格文档
接口能力
| 接口名称 | 能力简述 |
|---|---|
| 人体关键点识别 | 检测图像中的所有人体并返回每个人体的矩形框位置，精准定位21个核心关键点，包含四肢、脖颈、鼻子等部位，更多关键点持续扩展中；支持多人检测、人体位置重叠、遮挡、背面、侧面、中低空俯拍、大动作等复杂场景 |
| 人体检测和属性识别 | 检测图像中的所有人体并返回每个人体的矩形框位置，识别人体的静态属性和行为，共支持20余种属性，包括：性别、年龄阶段、衣着（含类别/颜色）、戴帽子（可区分安全帽/普通帽）、戴口罩、戴眼镜、背包、使用手机、抽烟、身体朝向等；支持中低空俯拍视角、人体重叠、遮挡、背面、侧面、动作变化等复杂场景 |
| 人流量统计 | 识别和统计图像当中的人体个数（静态统计，不支持追踪和去重），适用于3米以上的中远距离俯拍，以人头为主要识别目标统计人数，无需正脸、全身照，适应各类人流密集场景；默认识别整图中的人数，支持指定不规则区域的人数统计，同时可输出渲染图片 |
| 手势识别 | 识别图片中的手势类型，返回手势名称、手势矩形框、概率分数，可识别24种手势，支持动态手势识别，适用于手势特效、智能家居手势交互等场景；支持的手势列表：拳头、OK、祈祷、作揖、作别、单手比心、点赞、diss、我爱你、rock、掌心向上、竖中指、双手比心（3种）、数字（9种） |
| 人像分割 | 识别人体的轮廓范围，与背景进行分离，适用于拍照背景替换、照片合成、身体特效等场景；输入正常人像图片，返回分割后的二值结果图、灰度图、透明背景的人像图 |
| 人流量统计-动态版 | 动态人数统计和跟踪，主要适用于低空俯拍、出入口场景，以人体头肩为主要识别目标，核心功能：传入监控视频抓拍图片序列，进行人体追踪，根据目标轨迹判断进出区域行为，进行动态人数统计，返回区域进出人数。 |
| 驾驶行为分析 | 针对车载场景，检测图片中是否有驾驶员，并识别驾驶员是否有使用手机、抽烟、未系安全带、双手离开方向盘 等行为，可用于分析预警危险驾驶行为 |
| 手部关键点识别 | 检测图片中的所有人手，定位每只手的21个主要骨节点，可用于自定义手势识别、物体交互或AR特效等场景 |
| 危险行为识别（邀测） | 针对5s内的监控视频片段，识别行为类别，目前支持7类行为：单人-情绪性指人、单人-摔倒、单人-激烈抱怨、单人-砸东西、单人-正常、双人-危险（包含出拳/拉扯/推搡/激烈搂抱/砸按/踢踹等）、双人-正常 |
| 指尖检测（邀测） | 精准定位食指指尖、及4个辅助关键点的坐标位置，模型针对儿童学习机点读场景进行专项调优，可用于点读搜题、自动跟读等应用 |
| 人像分割-证件照版（邀测） | 针对自拍类单人图片，先基于人脸检测、人体关键点定位，裁剪出符合证件照场景的人像图片（头肩上半身），对裁剪后的图片进行发丝级精细化分割；接口返回裁剪后的原图、分割结果灰度图、合成的黑底效果图，并输出人脸框坐标、关键点坐标、人像姿态（正脸/侧脸/正肩/侧肩等）等辅助信息，便于筛选结果、二次开发 |
请求格式
POST方式调用
注意：Content-Type为application/x-www-form-urlencoded，然后通过urlencode格式化请求体。
返回格式
JSON格式
请求限制
请求图片需经过base64编码：图片的base64编码指将一副图片数据编码成一串字符串，使用该字符串代替图像地址。您可以首先得到图片的二进制，然后用Base64格式编码即可。
注意：图片的base64编码是不包含图片头的，如（data:image/jpg;base64,）
请求格式支持：PNG、JPG、BMP
| 接口名称 | 图片编码后大小限额 |
|---|---|
| 人体关键点识别 | base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M，最短边至少50px，最长边最大4096px ，建议长宽比3：1以内 |
| 人体检测和属性识别 | base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M，最短边至少50px，最长边最大4096px ，建议长宽比3：1以内 |
| 人流量统计 | base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M，最短边至少50px，最长边最大4096px ，建议长宽比3：1以内 |
| 手势识别 | base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M，最短边至少50px，最长边最大4096px ，建议长宽比3：1以内 |
| 人像分割 | base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M，最短边至少50px，最长边最大4096px ，建议长宽比3：1以内 |
| 驾驶行为分析 | base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M，最短边至少50px，最长边最大4096px ，建议长宽比3：1以内 |
| 人流量统计-动态版 | base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M，最短边至少50px，最长边最大4096px ，建议长宽比3：1以内 |
| 手部关键点识别 | base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M，最短边至少50px，最长边最大4096px ，建议长宽比3：1以内 |
| 危险行为识别（邀测） | 视频数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M，支持mp4, mov格式，5s以内的监控视频片段 |
| 指尖检测（邀测） | base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M，最短边至少50px，最长边最大4096px ，建议长宽比3：1以内 |
| 人像分割-证件照版（邀测） | base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M，最短边至少50px，最长边最大4096px ，建议长宽比3：1以内 |
