人脸识别高级属性特征
接口描述
- 提取大库检索使用的特征,能够返回人脸高级属性,如质量分、性别等等
请求说明
HTTP 方法:
POST
请求 URL:
/face/search/feature
Header如下:
参数名称 | 值 |
---|---|
Content-Type | application/json;charset=UTF-8 |
Body中放置请求参数,参数详情如下:
请求参数:
参数名称 | 数据类型 | 参数描述 |
---|---|---|
appKey | String | 应用生成的appkey |
sign | String | 签名 |
nonceStr | String | 随机字符串 |
img | String | 待处理图片(base64编码),建议上传小于3M, 像素在4000*3000 以内的图片 |
返回说明
返回参数:
返回值名称 | 类型 | 描述 |
---|---|---|
code | int | 返回结果,0表示成功,非0为对应错误号 |
success | Boolean | 是否成功 |
message | String | 返回描述 |
data | Object | 返回的数据如下 |
faces | Object | 返回检测到的人脸数据,数据如下 |
faceQualityScores | String | 结构化信息字段 |
返回示例:
{
"code": 0,
"data": {
"faceQualityScores": "0.8032,0.7761,0.9981,1.0000,1.0000,0.0532,0.2404,0.8032,1.0000,0.0000,33.0000,1.0000,1.0000,2.0000,0.0000,0.0000,2.7189,-1.9899,1.5270,8.0000,18.0000,34.0000,34.0000,0.8371
},
"success": true,
"message": "success"
}
结构化信息(faceQualityScores)按逗号分割,其中每一位数字所代表的具体信息如下:
[0]人脸质量总分 0.65
[1]光照分,越大表示光照越亮 推荐范围0.2-0.8
[2]口罩得分, 分数越大表示越不可能戴口罩
[3]人脸遮挡分数,返回0.0-1.0的分数,越大表示越有可能被遮挡
[4]清晰度,越大表示越清晰 推荐范围0.65-1.0
[5]是否戴眼镜分数,越大表示越可能戴眼镜 推荐范围0.0-0.5
[6]张嘴分数,越大表示越可能张嘴 推荐范围0.0-0.5
[7]人脸特征点质量分数, 越大表示人脸越清晰 0.6
[8]
[9]戴墨镜的置信分,越大表示戴墨镜的可能性越大 推荐范围0.0-0.5
[10] 年龄
[11] 性别 1 男 2 女
[12] 国籍 1 中国人 2 外国人
[13] 年龄段 1 小孩 2 中年人 4 老人
[14] 正脸侧脸 分数大表示是正脸 1.0
[15] 族裔 1 亚裔 2 非裔 4 欧美
[16] 人脸旋转角 pitch
[17] 人脸旋转角 yaw
[18] 人脸旋转角 roll
[19] 人脸框 x
[20] 人脸框 y
[21] 人脸框 width
[22] 人脸框 height
[23] 肤色接近真人肤色程度,越大表示越真实,推荐范围0.5-1.0
[24] 左眼睁眼分数, 越大表示左眼越可能是睁眼,推荐范围0.5-1.0
[25] 右眼睁眼分数, 越大表示右眼越可能是睁眼,推荐范围0.5-1.0