人脸探测（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] |
返回示例
{
"result_num": 1,
"result": [
{
"location": {
"left": 90,
"top": 92,
"width": 111,
"height": 99
},
"face_probability": 1,
"rotation_angle": 6,
"yaw": 11.61234664917,
"pitch": -0.30852827429771,
"roll": 8.8044967651367,
"landmark": [
{
"x": 105,
"y": 110
},
...
],
"landmark72": [
{
"x": 88,
"y": 109
},
...
],
"gender": "male",
"gender_probability": 0.99358034133911,
"glasses": 0,
"glasses_probability": 0.99991309642792,
"race": "yellow",
"race_probability": 0.99960690736771,
"qualities": {
"occlusion": {
"left_eye": 0.000085282314103097,
"right_eye": 0.00001094374601962,
"nose": 3.2677664307812e-7,
"mouth": 2.6582130940866e-10,
"left_cheek": 8.752236624332e-8,
"right_cheek": 1.0212766454742e-7,
"chin": 4.2632994357028e-10
},
"blur": 4.5613666312237e-41,
"illumination": 0,
"completeness": 0,
"type": {
"human": 0.98398965597153,
"cartoon": 0.016010366380215
}
}
}
],
"log_id": 2418894422
}