说明:
· 检测给定图片(Image)中的所有人脸(Face)的位置和相应的面部属性
· 目前面部属性包括性别(gender), 年龄(age), 眼镜(glass)和姿势(pose)
· 若结果的face_id没有被加入任何people之中，则在72小时之后过期被自动清除。
参数
| 是否必须 |
参数名 |
参数说明 |
| 必须 |
app_id |
APP调用眼神AI平台 API 的唯一标识 |
| |
app_key |
APP调用眼神AI平台 API 时需要的密钥 |
| |
url 或 img[POST] |
待检测图片的URL 或者 通过POST方法上传的二进制数据，原始图片大小需要小于3M |
| 可选 |
mode |
检测模式 (默认) oneface 。在oneface模式中，检测器仅找出图片中最大的一张脸。如果图中有多张人脸大小相同，随机返回一张人脸信息。 |
| |
tip |
指定一个不包含^@,&=*'"等非法字符且不超过255字节的字符串作为tip |
返回值
| 字段 |
类型 |
说明 |
| url |
string |
云平台服务器端图片地址 |
| face |
gather |
被检测出的人脸的列表 |
| img_id |
string |
眼神AI平台系统中的图片标识符，用于标识用户请求中的图片 |
| face_id |
string |
被检测出的每一张人脸都在眼神AI平台系统中的标识符 |
| img_width |
integer |
请求图片的宽度 |
| img_height |
integer |
请求图片的高度 |
| lefteye_opendegree |
integer |
检出人脸左眼的睁开程度(0~100之间的整数) |
| righteye_opendegree |
integer |
检出人脸右眼的睁开程度(0~100之间的整数) |
| mouth_opendegree |
integer |
检出人脸的嘴巴张开程度(0~100之间的整数) |
| position |
object |
人脸标记关键点的属性 |
| width |
float |
0~100之间的实数，表示检出的脸的宽度在图片中百分比 |
| height |
float |
0~100之间的实数，表示检出的脸的高度在图片中百分比 |
| center |
object |
检出的人脸框的中心点坐标, x & y 坐标分别表示在图片中的宽度和高度的百分比 (0~100之间的实数) |
| eye_left |
object |
相应人脸的左眼坐标，x & y 坐标分别表示在图片中的宽度和高度的百分比 (0~100之间的实数) |
| eye_right |
object |
相应人脸的右眼坐标，x & y 坐标分别表示在图片中的宽度和高度的百分比 (0~100之间的实数) |
| mouth_left |
object |
相应人脸的左侧嘴角坐标，x & y 坐标分别表示在图片中的宽度和高度的百分比 (0~100之间的实数) |
| mouth_right |
object |
相应人脸的右侧嘴角坐标，x & y 坐标分别表示在图片中的宽度和高度的百分比 (0~100之间的实数) |
| nose |
object |
相应人脸的鼻尖坐标，x & y 坐标分别表示在图片中的宽度和高度的百分比 (0~100之间的实数) |
| attribute |
object |
包含一系列人脸的属性分析结果 |
| gender |
object |
包含性别分析结果，值为Male/Female |
| age |
object |
包含年龄分析结果，值为一个非负整数表示估计的年龄 |
| becovered |
int |
人脸是否被遮挡的分析结果，1:无遮挡2:嘴巴遮挡；3：眼睛遮挡； |
| pose |
object |
包含脸部姿势分析结果，歪头tilting，抬低头raise，摇头turn。每个值为[-90,90]近似角度值；平面内左右歪头：正左、负右；扭头：正左、负右；低抬头：正抬、负低; |
| tip |
string |
指定一个不包含^@,&=*'"等非法字符且不超过255字节的字符串 |
JSON实例
{
"face": [
{
"attribute": {
"age": 23,
"gender": "Female",
"becovered": "1",
"pose": {
"tilting": 20,
"raise": 20,
"turn": -30,
}
},
"face_id": "17233b4b1b51ac91e391e5afe130eb78",
"lefteye_opendegree": 50,
"righteye_opendegree": 50,
"mouth_opendegree": 30,
"position": {
"center": {
"x": 49.4,
"y": 37.6
},
"eye_left": {
"x": 43.3692,
"y": 30.8192
},
"eye_right": {
"x": 56.5606,
"y": 30.9886
},
"height": 26.8,
"mouth_left": {
"x": 46.1326,
"y": 44.9468
},
"mouth_right": {
"x": 54.2592,
"y": 44.6282
},
"nose": {
"x": 49.9404,
"y": 38.8484
},
"width": 26.8
},
"tip": ""
}
],
"img_height": 500,
"img_id": "22fd9efc64c87e00224c33dd8718eec7",
"img_width": 500,
"url":"http://img3.imgtn.bdimg.com/it/u=151595761,811466030&fm=21&gp=0.jpg"
}
