接口地址:https://aip.baidubce.com/rest/2.0/face/v3/detect |
---|
返回格式:json |
请求方式:post |
请求示例:https://aip.baidubce.com/rest/2.0/face/v3/detect?access_token=test |
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
image | string | 必填 | 图片信息(总数据大小应小于10M),图片上传方式根据image_type来判断 |
image_type | string | 必填 | 图片类型 BASE64:图片的base64值,base64编码后的图片数据,编码后的图片大小不超过2M; URL:图片的 URL地址( 可能由于网络等原因导致下载图片时间过长); FACE_TOKEN: 人脸图片的唯一标识,调用人脸检测接口时,会为每个人脸图片赋予一个唯一的FACE_TOKEN,同一张图片多次检测得到的FACE_TOKEN是同一个。 |
face_field | string | 选填 | 包括age,beauty,expression,face_shape,gender,glasses,landmark,landmark72,landmark150,race,quality,eye_status,emotion,face_type信息 逗号分隔. 默认只返回face_token、人脸框、概率和旋转角度 |
max_face_num | uint32 | 选填 | 最多处理人脸的数目,默认值为1,仅检测图片中面积最大的那个人脸;最大值10,检测图片中面积最大的几张人脸。 |
face_type | string | 选填 | 人脸的类型 LIVE表示生活照:通常为手机、相机拍摄的人像图片、或从网络获取的人像图片等 IDCARD表示身份证芯片照:二代身份证内置芯片中的人像照片 WATERMARK表示带水印证件照:一般为带水印的小图,如公安网小图 CERT表示证件照片:如拍摄的身份证、工卡、护照、学生证等证件图片 默认LIVE |
名称 | 类型 | 说明 |
---|---|---|
face_num | 是 | 检测到的图片中的人脸数量 |
face_list | 是 | 人脸信息列表,具体包含的参数参考下面的列表。 |
+face_token | 是 | 人脸图片的唯一标识 |
+location | 是 | 人脸在图片中的位置 |
++left | 是 | 人脸区域离左边界的距离 |
++top | 是 | 人脸区域离上边界的距离 |
++width | 是 | 人脸区域的宽度 |
++height | 是 | 人脸区域的高度 |
++rotation | 是 | 人脸框相对于竖直方向的顺时针旋转角,[-180,180] |
+face_probability | 是 | 人脸置信度,范围【0~1】,代表这是一张人脸的概率,0最小、1最大。 |
+angel | 是 | 人脸旋转角度参数 |
++yaw | 是 | 三维旋转之左右旋转角[-90(左), 90(右)] |
++pitch | 是 | 三维旋转之俯仰角度[-90(上), 90(下)] |
++roll | 是 | 平面内旋转角[-180(逆时针), 180(顺时针)] |
+age | 否 | 年龄 ,当<strong>face_field包含age时返回</strong> |
+beauty | 否 | 美丑打分,范围0-100,越大表示越美。当<strong>face_fields包含beauty时返回</strong> |
+expression | 否 | 表情,当 <strong>face_field包含expression时返回</strong> |
++type | 否 | <strong>none</strong>:不笑;<strong>smile</strong>:微笑;<strong>laugh</strong>:大笑 |
++probability | 否 | 表情置信度,范围【0~1】,0最小、1最大。 |
+face_shape | 否 | 脸型,当<strong>face_field包含face_shape时返回</strong> |
++type | 否 | <strong>square</strong>: 正方形 <strong>triangle</strong>:三角形 <strong>oval</strong>: 椭圆 <strong>heart</strong>: 心形 <strong>round</strong>: 圆形 |
++probability | 否 | 置信度,范围【0~1】,代表这是人脸形状判断正确的概率,0最小、1最大。 |
+gender | 否 | 性别,<strong>face_field包含gender时返回</strong> |
++type | 否 | male:<strong>男性</strong> female:<strong>女性</strong> |
++probability | 否 | 性别置信度,范围【0~1】,0代表概率最小、1代表最大。 |
+glasses | 否 | 是否带眼镜,<strong>face_field包含glasses时返回</strong> |
++type | 否 | <strong>none</strong>:无眼镜,<strong>common</strong>:普通眼镜,<strong>sun</strong>:墨镜 |
++probability | 否 | 眼镜置信度,范围【0~1】,0代表概率最小、1代表最大。 |
+eye_status | 否 | 双眼状态(睁开/闭合) <strong>face_field包含eye_status时返回</strong> |
++left_eye | 否 | 左眼状态 [0,1]取值,越接近0闭合的可能性越大 |
++right_eye | 否 | 右眼状态 [0,1]取值,越接近0闭合的可能性越大 |
+emotion | 否 | 情绪 <strong>face_field包含emotion时返回</strong> |
++type | 否 | <strong>angry</strong>:愤怒 <strong>disgust</strong>:厌恶 <strong>fear</strong>:恐惧 <strong>happy</strong>:高兴<br><strong>sad</strong>:伤心 <strong>surprise</strong>:惊讶 <strong>neutral</strong>:无情绪 |
++probability | 否 | 情绪置信度,范围0~1 |
+race | 否 | 人种 <strong>face_field包含race时返回</strong> |
++type | 否 | <strong>yellow</strong>: 黄种人 <strong>white</strong>: 白种人 <strong>black</strong>:黑种人 <strong>arabs</strong>: <strong>阿拉伯人</strong> |
++probability | 否 | 人种置信度,范围【0~1】,0代表概率最小、1代表最大。 |
+face_type | 否 | 真实人脸/卡通人脸 <strong>face_field包含face_type时返回</strong> |
++type | 否 | <strong>human</strong>: 真实人脸 <strong>cartoon</strong>: 卡通人脸 |
++probability | 否 | 人脸类型判断正确的置信度,范围【0~1】,0代表概率最小、1代表最大。 |
+landmark | 否 | 4个关键点位置,左眼中心、右眼中心、鼻尖、嘴中心。<strong>face_field包含landmark时返回</strong> |
+landmark72 | 否 | 72个特征点位置 <strong>face_field包含landmark72时返回</strong> |
+landmark150 | 否 | 150个特征点位置 <strong>face_field包含landmark150时返回</strong> |
+quality | 否 | 人脸质量信息。<strong>face_field包含quality时返回</strong> |
++occlusion | 否 | 人脸各部分遮挡的概率,范围[0~1],0表示完整,1表示不完整 |
+++left_eye | 否 | 左眼遮挡比例,[0-1] ,1表示完全遮挡 |
+++right_eye | 否 | 右眼遮挡比例,[0-1] , 1表示完全遮挡 |
+++nose | 否 | 鼻子遮挡比例,[0-1] , 1表示完全遮挡 |
+++mouth | 否 | 嘴巴遮挡比例,[0-1] , 1表示完全遮挡 |
+++left_cheek | 否 | 左脸颊遮挡比例,[0-1] , 1表示完全遮挡 |
+++right_cheek | 否 | 右脸颊遮挡比例,[0-1] , 1表示完全遮挡 |
+++chin | 否 | 下巴遮挡比例,,[0-1] , 1表示完全遮挡 |
++blur | 否 | 人脸模糊程度,范围[0~1],0表示清晰,1表示模糊 |
++illumination | 否 | 取值范围在[0~255], 表示脸部区域的光照程度 越大表示光照越好 |
++completeness | 否 | 人脸完整度,0或1, 0为人脸溢出图像边界,1为人脸都在图像边界内 |
错误码 | 说明 |
---|---|
4 | 集群超限额 |
6 | 没有接口权限 |
17 | 每天流量超限额 |
18 | QPS超限额 |
19 | 请求总量超限额 |
100 | 无效的access_token参数 |
110 | Access Token失效 |
111 | Access token过期 |
222001 | 必要参数未传入 |
222002 | 参数格式错误 |
222003 | 参数格式错误 |
222004 | 参数格式错误 |
222005 | 参数格式错误 |
222006 | 参数格式错误 |
222007 | 参数格式错误 |
222008 | 参数格式错误 |
222009 | 参数格式错误 |
222010 | 参数格式错误 |
222011 | 参数格式错误 |
222012 | 参数格式错误 |
222013 | 参数格式错误 |
222014 | 参数格式错误 |
222015 | 参数格式错误 |
222016 | 参数格式错误 |
222017 | 参数格式错误 |
222018 | 参数格式错误 |
222019 | 参数格式错误 |
222020 | 参数格式错误 |
222021 | 参数格式错误 |
222022 | 参数格式错误 |
222023 | 参数格式错误 |
222024 | 参数格式错误 |
222025 | 参数格式错误 |
222026 | 参数格式错误 |
222027 | 验证码长度错误<br>(最小值大于最大值) |
222028 | 参数格式错误 |
222029 | 参数格式错误 |
222030 | 参数格式错误 |
222200 | 该接口需使用<br>application/json的<br>格式进行请求 |
222201 | 服务端请求失败 |
222202 | 图片中没有人脸 |
222203 | 无法解析人脸 |
222204 | 从图片的url下载<br>图片失败 |
222205 | 服务端请求失败 |
222206 | 服务端请求失败 |
222207 | 未找到匹配的用户 |
222208 | 图片的数量错误 |
222209 | face token不存在 |
222210 | 人脸库中用户下的人脸数目超过限制 |
222300 | 人脸图片添加失败 |
222301 | 获取人脸图片失败 |
222302 | 服务端请求失败 |
222303 | 获取人脸图片失败 |
223100 | 操作的用户组不存在 |
223101 | 该用户组已存在 |
223102 | 该用户已存在 |
223103 | 找不到该用户 |
223104 | group_list包含组<br>数量过多 |
223105 | 该人脸已存在 |
223106 | 该人脸不存在 |
223110 | uid_list包含数量过多 |
223111 | 目标用户组不存在 |
223112 | quality_conf格式不正确 |
223113 | 人脸有被遮挡 |
223114 | 人脸模糊 |
223115 | 人脸光照不好 |
223116 | 人脸不完整 |
223117 | app_list包含app数量<br>过多 |
223118 | 质量控制项错误 |
223119 | 活体控制项错误 |
223120 | 活体检测未通过 |
223121 | 质量检测未通过 左眼<br>遮挡程度过高 |
223122 | 质量检测未通过 右眼<br>遮挡程度过高 |
223123 | 质量检测未通过 左脸<br>遮挡程度过高 |
223124 | 质量检测未通过 右脸<br>遮挡程度过高 |
223125 | 质量检测未通过 下巴遮挡程度过高 |
223126 | 质量检测未通过 鼻子遮挡程度过高 |
223127 | 质量检测未通过 嘴巴<br>遮挡程度过高 |
222901 | 参数校验初始化失败 |
222902 | 参数校验初始化失败 |
222903 | 参数校验初始化失败 |
222904 | 参数校验初始化失败 |
222905 | 接口初始化失败 |
222906 | 接口初始化失败 |
222907 | 缓存处理失败 |
222908 | 缓存处理失败 |
222909 | 缓存处理失败 |
222910 | 数据存储处理失败 |
222911 | 数据存储处理失败 |
222912 | 数据存储处理失败 |
222913 | 接口初始化失败 |
222914 | 接口初始化失败 |
222915 | 后端服务连接失败 |
222916 | 后端服务连接失败 |
222304 | 图片尺寸太大 |
223128 | 正在清理该用户组的数据 |
222361 | 公安服务连接失败 |