人脸检测与属性识别
更新时间：2021-01-11
人脸检测与属性识别
检测图片中的人脸并获得位置信息、属性信息、特征信息和质量信息等;
请求Url
POST /v1/human/face/detect HTTP/1.1
Request参数
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| image_base64 | 必选 | String | 图片base64编码，iamge_base64和image_url二选一即可，优先使用image_base64 |
| image_url | 必选 | String | 图片url，只有当image_base64为空时才会使用image_url下载图片再base64编码，增加下载时延 |
| min_score | 可选 | Double | 最小置信度，如果指定该参数，会对检测、识别结果按min_score过滤，只保留置信度大于min_score的特征结果 |
| max_face_num | 可选 | Integer | 最多处理人脸的数目，默认值为10，最大值10，如果仅检测图片中面积最大的那个人脸，请设置值为1 |
| face_field | 可选 | String | 指定检测属性，逗号分隔，默认全部属性都检测 |
其中，face_field可选属性如下：
| 参数 | 说明 |
|---|---|
| age | 年龄 |
| beauty | 美丑打分，范围0-100，越大表示越美; |
| gender | 性别, male:男性 female:女性; |
| expression | 表情, none:不笑；smile:微笑；laugh:大笑; |
| face_shape | 脸型, square:正方形 triangle:三角形 oval:椭圆 heart:心形 round:圆形; |
| glasses | 是否带眼镜, none:无眼镜，common:普通眼镜，sun:墨镜; |
| race | 人种, yellow: 黄种人 white: 白种人 black: 黑种人 arabs: 阿拉伯人; |
| face_type | 真实人脸/卡通人脸, human: 真实人脸 cartoon: 卡通人脸; |
| mask | 口罩识别, 0代表没戴口罩 1代表戴口罩; |
| emotion | 情绪, angry:愤怒 disgust:厌恶 fear:恐惧 happy:高兴 sad:伤心 surprise:惊讶 neutral:无表情 pouty: 撅嘴 grimace:鬼脸; |
| skin | 皮肤属性 |
| eye_status | 双眼状态(睁开/闭合), 越接近0闭合的可能性越大; |
| quality | 人脸质量信息; |
| landmark | 4个关键点位置，左眼中心、右眼中心、鼻尖、嘴中心; 72个特征点位置; |
| feature | 人脸128维特征值 |
Response参数
| 参数 | 类型 | 说明 |
|---|---|---|
| code | Integer | 0：请求成功，非0：请求失败 |
| message | String | 请求成功message为空，请求失败为失败提示信息 |
| data | Object | 响应对象实体，包括属性列表和属性数量 |
| +items | List | 属性列表 |
| ++face_token | String | 人脸标识face_token |
| ++location | Object | 位置信息 |
| +++left | Integer | 位置相对左边框的坐标 |
| +++top | Integer | 位置相对上边框的坐标 |
| +++width | Integer | 人脸宽度 |
| +++height | Integer | 人脸高度 |
| +++rotation | Integer | 人脸角度 |
| ++score | Double | 人脸置信度，范围0~1 |
| ++age | Integer | 年龄 |
| ++beauty | Double | 美丑打分，范围0-100，越大表示越美 |
| ++angle | Object | 人脸旋转参数 |
| +++yaw | Double | 三维旋转之左右旋转角，范围：[-90(左), 90(右)]，推荐旋转角绝对值不大于20度 |
| +++pitch | Double | 三维旋转之俯仰角度，范围：[-90(上), 90(下)]，推荐俯仰角绝对值不大于20度 |
| +++roll | Double | 平面内旋转角，范围：[-180(逆时针), 180(顺时针)]，推荐旋转角绝对值不大于20度 |
| ++expression | Object | 表情, none:不笑；smile:微笑；laugh:大笑 |
| +++name | String | 表情属性值 |
| +++score | Double | 属性置信度，范围0~1 |
| ++face_shape | Object | 脸型, square:正方形 triangle:三角形 oval:椭圆 heart:心形 round:圆形 |
| +++name | String | 脸型属性值 |
| +++score | Double | 属性置信度，范围0~1 |
| ++skin | Object | 皮肤属性特征 |
| +++name | String | 皮肤属性值 |
| +++score | Double | 属性置信度，范围0~1 |
| ++gender | Object | 性别, male:男性 female:女性 |
| +++name | String | 性别属性值 |
| +++score | Double | 属性置信度，范围0~1 |
| ++glasses | Object | 是否带眼镜, none:无眼镜，common:普通眼镜，sun:墨镜 |
| +++name | String | 是否戴眼镜属性值 |
| +++score | Double | 属性置信度，范围0~1 |
| ++race | Object | 人种, yellow: 黄种人 white: 白种人 black: 黑种人 arabs: 阿拉伯人 |
| +++name | String | 人种属性值 |
| +++score | Double | 属性置信度，范围0~1 |
| ++face_type | Object | 真实人脸/卡通人脸, human: 真实人脸 cartoon: 卡通人脸 |
| +++name | String | 真实人脸属性值 |
| +++score | Double | 属性置信度，范围0~1 |
| ++mask | Object | 口罩识别, 0代表没戴口罩 1代表戴口罩 |
| +++name | String | 口罩属性值 |
| +++score | Double | 属性置信度，范围0~1 |
| ++emotion | Object | 情绪, angry:愤怒 disgust:厌恶 fear:恐惧 happy:高兴 sad:伤心 surprise:惊讶 neutral:无表情 pouty: 撅嘴 grimace:鬼脸 |
| +++name | String | 情绪属性值 |
| +++score | Double | 属性置信度，范围0~1 |
| ++quality | Object | 人脸质量信息 |
| +++occlusion | Object | 人脸各部分遮挡的概率，范围[0~1]，0表示完整，1表示不完整 |
| ++++left_eye | Double | 左眼遮挡比例 |
| ++++right_eye | Double | 右眼遮挡比例 |
| ++++nose | Double | 鼻子遮挡比例 |
| ++++mouth | Double | 嘴巴遮挡比例 |
| ++++left_cheek | Double | 左脸颊遮挡比例 |
| ++++right_cheek | Double | 右脸颊遮挡比例 |
| ++++chin_contour | Double | 下巴遮挡比例 |
| +++blur | Double | 人脸模糊程度，范围[0~1]，0表示清晰，1表示模糊 |
| +++illumination | Double | 取值范围在[0~255], 表示脸部区域的光照程度, 越大表示光照越好 |
| +++completeness | Long | 人脸完整度，0或1, 0为人脸溢出图像边界，1为人脸都在图像边界内 |
| ++eye_status | Object | 双眼状态(睁开/闭合), 越接近0闭合的可能性越大 |
| +++left_eye | Double | 左眼状态，范围0~1 |
| +++right_eye | Double | 右眼状态，范围0~1 |
| ++landmark | List | 4个关键点位置，左眼中心、右眼中心、鼻尖、嘴中心 |
| +++x | Integer | 关键点x坐标 |
| +++y | Integer | 关键点y坐标 |
| ++landmark72 | List | 72个关特征点位置 |
| +++x | Integer | 特征点x坐标 |
| +++y | Integer | 特征点y坐标 |
| ++feature | String | 128维特征值base64编码信息 |
| ++reid_feature | List | 128维特征值Double列表 |
| +item_count | Integer | 识别的item个数 |