人脸探测（face）
更新时间：2020-07-09
功能描述
- 检测请求图片中的人脸，返回人脸位置、72 个关键点坐标、及人脸相关属性信息。
- 检测响应速度，与图片中人脸数量相关，人脸数量较多时响应时间会有些许延长。
- 典型应用场景：如人脸属性分析，基于人脸关键点的加工分析，人脸营销活动等。
- 五官位置会标记具体坐标；72 个关键点坐标也包含具体坐标，但不包含对应位置的详细位置描述。
请求参数
无
返回参数
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| log_id | uint64 | 是 | 日志 id |
| result_num | uint32 | 是 | 人脸数目 |
| result | object[] | 是 | 人脸属性对象的集合 |
| +age | double | 否 | 年龄。face_fields 包含 age 时返回 |
| +beauty | double | 否 | 美丑打分，范围 0-100，越大表示越美。face_fields 包含 beauty 时返回 |
| +location | object | 是 | 人脸在图片中的位置 |
| ++left | uint32 | 是 | 人脸区域离左边界的距离 |
| ++top | uint32 | 是 | 人脸区域离上边界的距离 |
| ++width | uint32 | 是 | 人脸区域的宽度 |
| ++height | uint32 | 是 | 人脸区域的高度 |
| +face_probability | double | 是 | 人脸置信度，范围 0-1 |
| +rotation_angle | int32 | 是 | 人脸框相对于竖直方向的顺时针旋转角，[-180,180] |
| +yaw | double | 是 | 三维旋转之左右旋转角 [-90(左), 90(右)] |
| +pitch | double | 是 | 三维旋转之俯仰角度 [-90(上), 90(下)] |
| +roll | double | 是 | 平面内旋转角 [-180(逆时针), 180(顺时针)] |
| +expression | uint32 | 否 | 表情，0，不笑；1，微笑；2，大笑。face_fields包含expression时返回 |
| +expression_probability | double | 否 | 表情置信度，范围 0~1。face_fields 包含expression时返回 |
| +faceshape | object[] | 否 | 脸型置信度。face_fields 包含 faceshape 时返回 |
| ++type | string | 是 | 脸型：square/triangle/oval/heart/round |
| ++probability | double | 是 | 置信度：0~1 |
| +gender | string | 否 | male、female。face_fields 包含 gender时返回 |
| +gender_probability | double | 否 | 性别置信度，范围 0~1。face_fields 包含gender时返回 |
| +glasses | uint32 | 否 | 是否带眼镜，0-无眼镜，1-普通眼镜，2-墨镜。face_fields包含glasses时返回 |
| +glasses_probability | double | 否 | 眼镜置信度，范围 0~1。face_fields包含glasses时返回 |
| +landmark | object[] | 否 | 4 个关键点位置，左眼中心、右眼中心、鼻尖、嘴中心。face_fields包含landmark时返回 |
| ++x | uint32 | 否 | x坐标 |
| ++y | uint32 | 否 | y坐标 |
| +landmark72 | object[] | 否 | 72个特征点位置，示例图 。face_fields包含landmark时返回 |
| ++x | uint32 | 否 | x坐标 |
| ++y | uint32 | 否 | y坐标 |
| +race | string | 否 | yellow、white、black、arabs。face_fields包含race时返回 |
| +race_probability | double | 否 | 人种置信度，范围 0~1。face_fields包含race时返回 |
| +qualities | object | 否 | 人脸质量信息。face_fields 包含qualities时返回 |
| ++occlusion | object | 是 | 人脸各部分遮挡的概率， [0, 1] （待上线） |
| +++left_eye | double | 是 | 左眼 |
| +++right_eye | double | 是 | 右眼 |
| +++nose | double | 是 | 鼻子 |
| +++mouth | double | 是 | 嘴 |
| +++left_cheek | double | 是 | 左脸颊 |
| +++right_cheek | double | 是 | 右脸颊 |
| +++chin | double | 是 | 下巴 |
| ++blur | double | 是 | 人脸模糊程度，[0, 1]。0表示清晰，1表示模糊（待上线） |
| ++illumination | - | 是 | 取值范围在[0,255],表示脸部区域的光照程度（待上线） |
| ++completeness | - | 是 | 人脸完整度，[0, 1]。0表示完整，1表示不完整（待上线） |
| ++type | object | 是 | 真实人脸/卡通人脸置信度 |
| +++human | - | 是 | 真实人脸置信度，[0, 1] |
| +++cartoon | - | 是 | 卡通人脸置信度，[0, 1] |
返回示例
Plain Text
1{
2 "result_num": 1,
3 "result": [
4 {
5 "location": {
6 "left": 90,
7 "top": 92,
8 "width": 111,
9 "height": 99
10 },
11 "face_probability": 1,
12 "rotation_angle": 6,
13 "yaw": 11.61234664917,
14 "pitch": -0.30852827429771,
15 "roll": 8.8044967651367,
16 "landmark": [
17 {
18 "x": 105,
19 "y": 110
20 },
21 ...
22 ],
23 "landmark72": [
24 {
25 "x": 88,
26 "y": 109
27 },
28 ...
29 ],
30 "gender": "male",
31 "gender_probability": 0.99358034133911,
32 "glasses": 0,
33 "glasses_probability": 0.99991309642792,
34 "race": "yellow",
35 "race_probability": 0.99960690736771,
36 "qualities": {
37 "occlusion": {
38 "left_eye": 0.000085282314103097,
39 "right_eye": 0.00001094374601962,
40 "nose": 3.2677664307812e-7,
41 "mouth": 2.6582130940866e-10,
42 "left_cheek": 8.752236624332e-8,
43 "right_cheek": 1.0212766454742e-7,
44 "chin": 4.2632994357028e-10
45 },
46 "blur": 4.5613666312237e-41,
47 "illumination": 0,
48 "completeness": 0,
49 "type": {
50 "human": 0.98398965597153,
51 "cartoon": 0.016010366380215
52 }
53 }
54 }
55 ],
56 "log_id": 2418894422
57}