人体检测与属性识别
更新时间：2025-08-04
对于输入的一张图片（可正常解码，且长宽比适宜），检测图像中的所有人体并返回每个人体的矩形框位置，识别人体的静态属性和行为，共支持22种属性，包括：性别、年龄阶段、衣着（含类别/颜色）、戴帽子（可区分安全帽/普通帽）、戴口罩、戴眼镜、背包、抽烟、使用手机、身体朝向等。
主要适用于监控场景的中低空斜拍视角，支持人体轻度重叠、轻度遮挡、背面、侧面、动作变化等复杂场景。
摄像头硬件选型无特殊要求，分辨率建议720p以上，更低分辨率的图片也能识别，只是效果可能有差异。
暂不适用夜间红外监控图片，后续会考虑扩展。
注：接口返回的属性信息包括人体的遮挡、截断情况，在应用时可基于此过滤掉“无效人体”，比如严重遮挡、严重截断的人体。
人体检测的效果示例如下：
非正常人体示例：严重截断
22种属性及其输出项如下，持续扩展更多属性，敬请期待。
| 序号 | 属性 | 接口字段 | 输出项说明 |
|---|---|---|---|
| 1 | 性别 | gender | 男性、女性 |
| 2 | 年龄阶段 | age | 幼儿、青少年、青年、中年、老年 |
| 3 | 上身服饰 | upper_wear | 长袖、短袖 |
| 4 | 下身服饰 | lower_wear | 长裤、短裤、长裙、短裙、不确定 |
| 5 | 上身服饰颜色 | upper_color | 红、橙、黄、绿、蓝、紫、粉、黑、白、灰、棕 |
| 6 | 下身服饰颜色 | lower_color | 红、橙、黄、绿、蓝、紫、粉、黑、白、灰、棕、不确定 |
| 7 | 上身服饰纹理 | upper_wear_texture | 纯色、图案、碎花、条纹或格子 |
| 8 | 背包 | bag | 无背包、单肩包、双肩包、不确定 |
| 9 | 上身服饰细分类 | upper_wear_fg | T恤、无袖、衬衫、西装、毛衣、夹克、羽绒服、风衣、外套 |
| 10 | 是否戴帽子 | headwear | 无帽、普通帽、安全帽 |
| 11 | 是否戴口罩 | face_mask | 无口罩、戴口罩、不确定 |
| 12 | 是否戴眼镜 | glasses | 戴眼镜、戴墨镜、无眼镜、不确定 |
| 13 | 是否撑伞 | umbrella | 撑伞、无撑伞 |
| 14 | 是否使用手机 | cellphone | 未使用手机、使用手机、不确定 |
| 15 | 身体朝向 | orientation | 正面、背面、左侧面、右侧面 |
| 16 | 是否吸烟 | smoke | 吸烟、未吸烟、不确定 |
| 17 | 是否有手提物 | carrying_item | 无手提物、有手提物、不确定 |
| 18 | 交通工具 | vehicle | 无交通工具、骑摩托车、骑自行车、骑三轮车 |
| 19 | 上方截断 | upper_cut | 无上方截断、有上方截断 |
| 20 | 下方截断 | lower_cut | 无下方截断、有下方截断 |
| 21 | 遮挡 | occlusion | 无遮挡、轻度遮挡、重度遮挡 |
| 22 | 是否是正常人体 | is_human | 非正常人体、正常人体；正常人体：身体露出大于二分之一的人体，一般以能看到腰部肚挤眼为标准；非正常人体：严重截断、严重遮挡的人体，一般是看不到肚挤眼的，比如只有个脑袋、一条腿 |
注意：接口默认输出所有22个属性，如只需返回某几个特定属性，请将type 参数值设定属性可选值，用逗号分隔。
public void BodyAttrDemo() {
var image = File.ReadAllBytes("图片文件路径");
// 调用人体检测与属性识别，可能会抛出网络等异常，请使用try/catch捕获
var result = client.BodyAttr(image);
Console.WriteLine(result);
// 如果有可选参数
var options = new Dictionary<string, object>{
{"type", "gender"}
};
// 带参数调用人体检测与属性识别
result = client.BodyAttr(image, options);
Console.WriteLine(result);
}人体检测与属性识别 请求参数详情
| 参数名称 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| image | 是 | byte[] | 二进制图像数据 |
| type | 否 | string | 1）可选值说明： gender-性别， age-年龄阶段， lower_wear-下身服饰， upper_wear-上身服饰， headwear-是否戴帽子， face_mask-是否戴口罩， glasses-是否戴眼镜， upper_color-上身服饰颜色， lower_color-下身服饰颜色， cellphone-是否使用手机， upper_wear_fg-上身服饰细分类， upper_wear_texture-上身服饰纹理， orientation-身体朝向， umbrella-是否撑伞； bag-背包, smoke-是否吸烟, vehicle-交通工具, carrying_item-是否有手提物, upper_cut-上方截断, lower_cut-下方截断, occlusion-遮挡， is_human-是否正常人体 2）type 参数值可以是可选值的组合，用逗号分隔；如果无此参数默认输出全部21个属性 |
人体检测与属性识别 返回数据参数详情
| 字段 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| log_id | 是 | uint64 | 唯一的log id，用于问题定位 |
| person_num | 是 | uint32 | 人体数目 |
| person_info | 是 | object[] | 人体姿态信息 |
| +location | 是 | object | 人体坐标信息 |
| ++height | 是 | float | 人体区域的高度 |
| ++left | 是 | float | 人体区域离左边界的距离 |
| ++top | 是 | float | 人体区域离上边界的距离 |
| ++width | 是 | float | 人体区域的宽度 |
| ++score | 否 | float | 人体置信度分数，取值0-1，越接近1，代表人体的概率越大 |
| +attributes | 否 | object | 人体属性内容 |
| ++gender | 否 | object | 性别 |
| +++name | 否 | string | 男性、女性、不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++age | 否 | object | 年龄阶段 |
| +++name | 否 | string | 幼儿、青少年、青年、中年、老年、不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++upper_color | 否 | object | 上半身衣着颜色 |
| +++name | 否 | string | 红、橙、黄、绿、蓝、紫、粉、黑、白、灰、棕、不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++lower_color | 否 | object | 下半身衣着颜色 |
| +++name | 否 | string | 红、橙、黄、绿、蓝、紫、粉、黑、白、灰、棕、不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++cellphone | 否 | object | 是否使用手机 |
| +++name | 否 | string | 未使用手机、使用手机、不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++lower_wear | 否 | object | 下半身服饰 |
| +++name | 否 | string | 长裤、短裤、长裙、短裙、不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++upper_wear | 否 | object | 上半身服饰 |
| +++name | 否 | string | 长袖、短袖、不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++headwear | 否 | object | 是否戴帽子 |
| +++name | 否 | string | 无帽、普通帽、安全帽、不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++face_mask | 否 | object | 是否戴口罩 |
| +++name | 否 | string | 无口罩、戴口罩、不确定（背面或者头部被截断的人体，一般为不确定） |
| +++score | 否 | float | 对应概率分数 |
| ++glasses | 否 | object | 是否戴眼镜 |
| +++name | 否 | string | 戴眼镜、戴墨镜、无眼镜、不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++upper_wear_fg | 否 | object | 上身服饰细分类 |
| +++name | 否 | string | T恤、无袖、衬衫、西装、毛衣、夹克、羽绒服、风衣、外套、不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++upper_wear_texture | 否 | object | 上身服饰纹理 |
| +++name | 否 | string | 纯色、图案、碎花、条纹或格子、不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++orientation | 否 | object | 身体朝向 |
| +++name | 否 | string | 正面、背面、侧面、不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++umbrella | 否 | object | 是否撑伞 |
| +++name | 否 | string | 未撑伞、撑伞、不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++bag | 否 | object | 背包 |
| +++name | 否 | string | 无背包、单肩包、双肩包、不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++smoke | 否 | object | 是否吸烟 |
| +++name | 否 | string | 未吸烟、吸烟、不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++vehicle | 否 | object | 交通工具 |
| +++name | 否 | string | 无交通工具、骑摩托车、骑自行车、骑三轮车、不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++upper_cut | 否 | object | 上方截断 |
| +++name | 否 | string | 无上方截断，有上方截断，不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++lower_cut | 否 | object | 下方截断 |
| +++name | 否 | string | 无下方截断，有下方截断，不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++occlusion | 否 | object | 遮挡 |
| +++name | 否 | string | 无遮挡，轻度遮挡，重度遮挡，不确定 |
| +++score | 否 | float | 对应概率分数 |
| ++is_human | 否 | object | 是否是正常人体 |
| +++name | 否 | string | 正常人体，非正常人体，不确定 |
| +++score | 否 | float | 对应概率分数 |
人体检测与属性识别 返回示例
{
"person_num": 1,
"person_info":[
{
"attributes": {
"upper_wear_fg": {
"score": 0.6084373593330383,
"name": "T恤"
},
"cellphone": {
"score": 0.9986445307731628,
"name": "未使用手机"
},
"lower_cut": {
"score": 0.999593198299408,
"name": "无下方截断"
},
"umbrella": {
"score": 0.9999368190765381,
"name": "未打伞"
},
"orientation": {
"score": 0.6865364909172058,
"name": "左侧面"
},
"headwear": {
"score": 0.323924720287323,
"name": "普通帽"
},
"face_mask": {
"score": 0.973924720287323,
"name": "无口罩"
},
"gender": {
"score": 0.8240132331848145,
"name": "女性"
},
"age": {
"score": 0.9495382308959961,
"name": "青年"
},
"upper_cut": {
"score": 0.9999241828918457,
"name": "无上方截断"
},
"glasses": {
"score": 0.9292197823524475,
"name": "无眼镜"
},
"lower_color": {
"score": 0.3373721539974213,
"name": "黄"
},
"bag": {
"score": 0.9770514369010925,
"name": "无背包"
},
"upper_wear_texture": {
"score": 0.7113875150680542,
"name": "纯色"
},
"smoke": {
"score": 0.9982085227966309,
"name": "未吸烟"
},
"vehicle": {
"score": 0.9907247424125671,
"name": "无交通工具"
},
"lower_wear": {
"score": 0.9739166498184204,
"name": "短裤"
},
"carrying_item": {
"score": 0.9735746383666992,
"name": "无手提物"
},
"upper_wear": {
"score": 0.7128473520278931,
"name": "长袖"
},
"occlusion": {
"score": 0.999269425868988,
"name": "无遮挡"
},
"upper_color": {
"score": 0.4870010614395142,
"name": "白"
},
"is_human": {
"score": 0.4870010614395142,
"name": "正常人体"
}
},
"location": {
"height": 369,
"width": 316,
"top": 1,
"score": 0.9756121635437012,
"left": 58
}
}],
"log_id": 6482262517986539034
}