人脸应用标准接口
1. 照片分析(特征值与质量分析)
分析照片特征值和质量分数
请求⽅式: POST
请求地址: http://{server}/staticdb/search/feature
请求头:
请求参数:
{
"app_id":"system",
"app_secret":"12345",
"img":"YmFzZTY0IGltYWdlCg=="
}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
app_id | 是 | 应用id |
app_secret | 是 | 应用secret |
groupId | 否 | 人脸库编号 |
img | 是 | 图片base64 |
返回结果:
{
"feature": "MzQxZmFzZDQxMjM0MTIzNDEyCg==",
"info": "success",
"qualityScores": "0.7341,0.6496,0.0000,0.0008,0.9145,0.5783,0.0005,0.9721,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,0.0000,-2.7956,0.9578,-1.3971,97.0000,155.0000,199.0000,199.0000,1.0000,0.9635,0.8536,0.0000,0.0000,0.0000,0.0000,0240bea626980479fdcf0e30a248032d",
"result": 0
}
参数说明:
参数 | 说明 |
---|---|
info | 返回信息描述,成功为success,失败为错误描述信息 |
result | 返回码0成功,返回其他值为失败 |
feature | 照片特征值 |
qualityScores | 照片质量评分,逗号间隔开 |
结构化信息(qualityScores)按逗号分割,其中每一位数字所代表的具体信息如下:
[0]人脸质量总分,返回0.0-1.0的分数,分数越大表示照片质量越高
[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 白种人 8 新疆人
[16] 人脸旋转角-抬头低头角度 pitch
[17] 人脸旋转角-左右旋转角度 yaw
[18] 人脸旋转角-平面内偏头角度 roll
[19] 人脸框 x
[20] 人脸框 y
[21] 人脸框 width
[22] 人脸框 height
[23] 是否黑白打印纸张,越大表示越可能是真人
[24] 左眼睁眼分数, 越大表示左眼越可能是睁眼,推荐范围0.5-1.0
[25] 右眼睁眼分数, 越大表示右眼越可能是睁眼,推荐范围0.5-1.0
注:如果无法提供qualityScores中的所有参数,请至少提供“[0]人脸质量总分”
接口调用失败请查看开发指南-Token与Api调用失败须知