Appearance
人脸属性识别 #
功能简介 #
- 能力说明:检测图像中的所有人脸并返回每个人脸的属性值。 展示38种人脸属性信息,包括性别(男、女)、满脸胡须、拱形眉毛、漂亮的、眼袋、秃头、前刘海、大嘴唇、大鼻子、黑头发、金发、模糊、棕色头发、浓密的眉毛、戴眼镜的、山羊胡、灰色头发、双下巴、丰满的、浓妆、高颧骨、嘴略张开、小胡子、小眼睛、无胡子、鹅蛋脸、苍白皮肤、尖鼻、发际线高、红扑扑的脸、两鬓胡须、微笑、直发、波浪状头发、戴耳环、戴着帽子、涂口红、青年)。
- 适用范围:支持一张图,并且图片中只有多张人脸;最小支持50x50 像素,最大无限制。
AI能力集成 #
- 外部应用最多只需调用两个接口,就可以完成一次AI能力集成,对不同图像识别能力,接口是固定的:其一是识别能力接口,其二是用户反馈接口
识别能力接口 #
接口说明
检测图像中的所有人脸并返回每个人脸的属性值
接口URL
访问方式
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头 |
- 返回参数
{
"status": 200,
"message": "OK",
"data": {
"FaceAttrs": [
{
"rect": {//第一个人脸框
"w": 71,
"h": 95,
"x": 377,
"y": 107
},
"attributes": [
{
"score": 0.57617712020874023,
"index": 2
},
{
"score": 0.57480430603027344,
"index": 3
},
...
]
},
{
"rect": {//第二个人脸框
"w": 71,
"h": 98,
"x": 191,
"y": 92
},
"attributes": [
{
"score": 0.44041997194290161,
"index": 11
},
{
"score": 0.36063510179519653,
"index": 12
},
...
]
}
],
"result": "ok"
}
}
- 返回参数说明
*参数名* | *类型* | *说明* | |
---|---|---|---|
message | Y | string | 返回描述 |
status | Y | int | code状态码 |
data | Y | object | 识别结果对象 |
+result | Y | string | 算法层执行结果 |
+FaceAttrs | Y | int | 识别到的人脸属性 |
++rect | Y | object | 人脸质量对应的人头框体,xy,定位在图中的坐标,w表示宽度,h表示高度即可绘制人头框体 |
++attributes | Y | object[] | 属性提取元素列表 |
+++score | Y | float | 属性值的可信度,总值为1 |
+++index | Y | int | 属性索引对照,请参见人脸属性索引对照表 |
*人脸属性索引对照表* #
*人脸属性索引值* | *英文语义* | *中文语义* |
---|---|---|
0 | FIVE_O_CLOCK_SHADOW | 满脸胡须 |
1 | ARCHED_EYEBROWS | 拱形眉毛 |
2 | ATTRACTIVE | 漂亮的 |
3 | BAGS_UNDER_EYES | 眼袋 |
4 | BALD | 秃头 |
5 | BANGS | 前刘海 |
6 | BIG_LIPS | 大嘴唇 |
7 | BIG_NOSE | 大鼻子 |
8 | BLACK_HAIR | 黑头发 |
9 | BLOND_HAIR | 金发 |
10 | BLURRY | 模糊 |
11 | BROWN_HAIR | 棕色头发 |
12 | BUSHY_EYEBROWS | 浓密的眉毛 |
13 | CHUBBY | 丰满的 |
14 | DOUBLE_CHIN | 双下巴 |
15 | EYEGLASSES | 戴眼镜的 |
16 | GOATEE | 山羊胡 |
17 | GRAY_HAIR | 灰色头发 |
18 | HEAVY_MAKEUP | 浓妆 |
19 | HIGH_CHEEKBONES | 高颧骨 |
20 | GENDER | 性别 |
21 | MOUTH_SLIGHTLY_OPEN | 嘴略张开 |
22 | MUSTACHE | 小胡子 |
23 | NARROW_EYES | 小眼睛 |
24 | NO_BEARD | 无胡子 |
25 | OVAL_FACE | 鹅蛋脸 |
26 | PALE_SKIN | 皮肤苍白 |
27 | POINTY_NOSE | 鼻尖 |
28 | RECEDING_HAIRLINE | 发际线高 |
29 | ROSY_CHEEKS | 红仆仆的脸 |
30 | SIDEBURNS | 两鬓胡须 |
31 | SMILING | 微笑 |
32 | STRAIGHT_HAIR | 直发 |
33 | WAVY_HAIR | 波浪形头发 |
34 | WEARING_EARRINGS | 戴耳环 |
35 | WEARING_HAT | 戴帽子 |
36 | WEARING_LIPSTICK | 涂口红 |
37 | YOUNG | 青年 |
用户反馈接口 #
接口说明
用户在调用识别能力后,需要反馈识别能力识别的信息是否准确。用户反馈接口和能力识别接口通过业务流水号唯一标识进行关联。
调用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 }