Appearance
人脸质量提取 #
功能简介 #
- 能力说明:对于输入的一张人像图(可正常解码,且长宽比适宜)对其中包含的人脸进行系统的ai算法检测并进行人脸质量置信度判断。 返回人脸各部分的遮挡、光照、模糊、完整度、置信度等信息。
- 支持数量:支持多张人像图。
- 支持像素:最小支持50x50 像素,最大无限制。
AI能力集成 #
- 外部应用最多只需调用两个接口,就可以完成一次AI能力集成,对不同图像识别能力,接口是固定的:其一是识别能力接口,其二是用户反馈接口
识别能力接口 #
接口说明
输入一张图片,检测图像中的所有人脸的质量。
接口URL
https://aicp.teamshub.com/sitech/aiopen/FaceQualityExtraction
访问方式
POST
接口头部参数
Content-Type:application/json token:"token" 注:可用的token需要联系管理员进行申请
参数 | 值 |
---|---|
Content-Type | multipart/form-data |
Body参数
"file": "图片文件", "baseLs": "图片BASE64编码"
请求参数说明
*参数名* | *是否必传* | *类型* | *说明* |
---|---|---|---|
file | Y | file | 图片文件 |
baseLs | N | string | 图片的BASE64编码(与file二传一即可), 不含BASE64头 |
- 返回参数
{
{
"face_quality": [
{
"rect": {//第一张人脸
"w": 71,
"h": 95,
"x": 377,
"y": 107
},
"qualities": [
1,
1,
0,
0,
0
]
},
{
"rect": {//第二张人脸
"w": 71,
"h": 98,
"x": 191,
"y": 92
},
"qualities": [
2,
1,
0,
0,
0
]
}
]
}
}
- 返回参数说明
*参数名* | *类型* | *说明* | |
---|---|---|---|
message | Y | string | 返回描述 |
status | Y | int | code状态码 |
data | Y | object | 返回JSON对象 |
+result | Y | string | 算法层执行结果 |
+face_quality | Y | object[] | 人脸质量信息数组 |
++rect | Y | object | 人脸质量对应的人头框体,xy,定位在图中的坐标,w表示宽度,h表示高度即可绘制人头框体 |
++qualities | Y | object | 人脸质量,一共5个元素,每个元素取值1与0,1表示有该质量,0则无,质量对照值见下表 |
返回结果中的data.face_quality[x],x元素的对应属性
*qualities-1:第一个参数*
*NAME* | *VALUE* | *人脸质量说明* |
---|---|---|
ML_NO_ANGLE | 0 | 无角度 |
ML_LITTLE_ANGLE | 1 | 小角度 |
ML_BIG_ANGLE | 2 | 大角度 |
*qualities-2:第二个参数*
*NAME* | *VALUE* | *人脸质量说明* |
---|---|---|
ML_NO_EXPRESSION | 0 | 无表情 |
ML_LITTLE_EXPRESSION | 1 | 小表情 |
ML_LARGE_EXPRESSION | 2 | 大表情 |
*qualities-:3第三个参数*
*NAME* | *VALUE* | *人脸质量说明* |
---|---|---|
ML_CLEAR | 0 | 清晰 |
ML_LITTLE_BLUR | 1 | 轻模糊 |
ML_BLUR | 2 | 模糊 |
ML_BIG_BLUR | 2 | 重模糊 |
*qualities-4:第四个参数*
*NAME* | *VALUE* | *人脸质量说明* |
---|---|---|
ML_FULL_FACE | 0 | 完整 |
ML_PART_FACE | 1 | 不完整 |
*qualities-5:第五个参数*
*NAME* | *VALUE* | *人脸质量说明* |
---|---|---|
ML_FACE | 0 | 人脸 |
ML_NOT_FACE | 1 | 非人脸 |
用户反馈接口 #
接口说明
用户在调用识别能力后,需要反馈识别能力识别的信息是否准确。用户反馈接口和能力识别接口通过业务流水号唯一标识进行关联。
调用URL:
https://aicp.teamshub.com/feedback/sitech/feedbackInformation
Header:
参数 值 Content-Type application/json token string 调用方法:
post
请求参数:
参数名 类型 是否必选 参数说明 serialNumber String 是 业务流水号 jobNumber String 否 业务工单号 information String 是 用户修正信息(转义的json字符串,每个能力不同) modifyFlag Boolean 是 修改标记(true 已修改,false 未修改) feedbackFlag Boolean 是 反馈标识 (true为正确,false为错误) time String 否 工单发生时间,不填默认查当天 请求报文示例:
{ "serialNumber":"8063200944317145088", "jobNumber":"test_jobNumber", "time":"2021-03-25", "modifyFlag":true, "feedbackFlag":false, "information":"{}" }
返回值描述:
参数名 类型 参数说明 flag Boolean 成功标识 resultCode Long 状态码 message String 返回信息 data JSON 返回结果 serialNumber String 业务流水号 成功返回示例:
{ "flag": true, "resultCode": 0, "message": "系统处理正常", "data": { "xxx":"" } }
失败返回示例:
{ "flag": false, "resultCode": 1, "message": "服务端报错", "data": null }