人脸检测与属性识别
所有文档

          智能视联网平台 EVS

          人脸检测与属性识别

          人脸检测与属性识别

          检测图片中的人脸并获得位置信息、属性信息、特征信息和质量信息等;

          请求Url

          POST /v1/human/face/detect HTTP/1.1

          Request参数

          参数 可选 类型 说明
          image_base64 必选 String 图片base64编码,iamge_base64和image_url二选一即可,优先使用image_base64
          image_url 必选 String 图片url,只有当image_base64为空时才会使用image_url下载图片再base64编码,增加下载时延
          min_score 可选 Double 最小置信度,如果指定该参数,会对检测、识别结果按min_score过滤,只保留置信度大于min_score的特征结果
          max_face_num 可选 Integer 最多处理人脸的数目,默认值为10,最大值10,如果仅检测图片中面积最大的那个人脸,请设置值为1
          face_field 可选 String 指定检测属性,逗号分隔,默认全部属性都检测

          其中,face_field可选属性如下:

          参数 说明
          age 年龄
          beauty 美丑打分,范围0-100,越大表示越美;
          gender 性别, male:男性 female:女性;
          expression 表情, none:不笑;smile:微笑;laugh:大笑;
          face_shape 脸型, square:正方形 triangle:三角形 oval:椭圆 heart:心形 round:圆形;
          glasses 是否带眼镜, none:无眼镜,common:普通眼镜,sun:墨镜;
          race 人种, yellow: 黄种人 white: 白种人 black: 黑种人 arabs: 阿拉伯人;
          face_type 真实人脸/卡通人脸, human: 真实人脸 cartoon: 卡通人脸;
          mask 口罩识别, 0代表没戴口罩 1代表戴口罩;
          emotion 情绪, angry:愤怒 disgust:厌恶 fear:恐惧 happy:高兴 sad:伤心 surprise:惊讶 neutral:无表情 pouty: 撅嘴 grimace:鬼脸;
          skin 皮肤属性
          eye_status 双眼状态(睁开/闭合), 越接近0闭合的可能性越大;
          quality 人脸质量信息;
          landmark 4个关键点位置,左眼中心、右眼中心、鼻尖、嘴中心; 72个特征点位置;
          feature 人脸128维特征值

          Response参数

          参数 类型 说明
          code Integer 0:请求成功,非0:请求失败
          message String 请求成功message为空,请求失败为失败提示信息
          data Object 响应对象实体,包括属性列表和属性数量
          +items List 属性列表
          ++face_token String 人脸标识face_token
          ++location Object 位置信息
          +++left Integer 位置相对左边框的坐标
          +++top Integer 位置相对上边框的坐标
          +++width Integer 人脸宽度
          +++height Integer 人脸高度
          +++rotation Integer 人脸角度
          ++score Double 人脸置信度,范围0~1
          ++age Integer 年龄
          ++beauty Double 美丑打分,范围0-100,越大表示越美
          ++angle Object 人脸旋转参数
          +++yaw Double 三维旋转之左右旋转角,范围:[-90(左), 90(右)],推荐旋转角绝对值不大于20度
          +++pitch Double 三维旋转之俯仰角度,范围:[-90(上), 90(下)],推荐俯仰角绝对值不大于20度
          +++roll Double 平面内旋转角,范围:[-180(逆时针), 180(顺时针)],推荐旋转角绝对值不大于20度
          ++expression Object 表情, none:不笑;smile:微笑;laugh:大笑
          +++name String 表情属性值
          +++score Double 属性置信度,范围0~1
          ++face_shape Object 脸型, square:正方形 triangle:三角形 oval:椭圆 heart:心形 round:圆形
          +++name String 脸型属性值
          +++score Double 属性置信度,范围0~1
          ++skin Object 皮肤属性特征
          +++name String 皮肤属性值
          +++score Double 属性置信度,范围0~1
          ++gender Object 性别, male:男性 female:女性
          +++name String 性别属性值
          +++score Double 属性置信度,范围0~1
          ++glasses Object 是否带眼镜, none:无眼镜,common:普通眼镜,sun:墨镜
          +++name String 是否戴眼镜属性值
          +++score Double 属性置信度,范围0~1
          ++race Object 人种, yellow: 黄种人 white: 白种人 black: 黑种人 arabs: 阿拉伯人
          +++name String 人种属性值
          +++score Double 属性置信度,范围0~1
          ++face_type Object 真实人脸/卡通人脸, human: 真实人脸 cartoon: 卡通人脸
          +++name String 真实人脸属性值
          +++score Double 属性置信度,范围0~1
          ++mask Object 口罩识别, 0代表没戴口罩 1代表戴口罩
          +++name String 口罩属性值
          +++score Double 属性置信度,范围0~1
          ++emotion Object 情绪, angry:愤怒 disgust:厌恶 fear:恐惧 happy:高兴 sad:伤心 surprise:惊讶 neutral:无表情 pouty: 撅嘴 grimace:鬼脸
          +++name String 情绪属性值
          +++score Double 属性置信度,范围0~1
          ++quality Object 人脸质量信息
          +++occlusion Object 人脸各部分遮挡的概率,范围[0~1],0表示完整,1表示不完整
          ++++left_eye Double 左眼遮挡比例
          ++++right_eye Double 右眼遮挡比例
          ++++nose Double 鼻子遮挡比例
          ++++mouth Double 嘴巴遮挡比例
          ++++left_cheek Double 左脸颊遮挡比例
          ++++right_cheek Double 右脸颊遮挡比例
          ++++chin_contour Double 下巴遮挡比例
          +++blur Double 人脸模糊程度,范围[0~1],0表示清晰,1表示模糊
          +++illumination Double 取值范围在[0~255], 表示脸部区域的光照程度, 越大表示光照越好
          +++completeness Long 人脸完整度,0或1, 0为人脸溢出图像边界,1为人脸都在图像边界内
          ++eye_status Object 双眼状态(睁开/闭合), 越接近0闭合的可能性越大
          +++left_eye Double 左眼状态,范围0~1
          +++right_eye Double 右眼状态,范围0~1
          ++landmark List 4个关键点位置,左眼中心、右眼中心、鼻尖、嘴中心
          +++x Integer 关键点x坐标
          +++y Integer 关键点y坐标
          ++landmark72 List 72个关特征点位置
          +++x Integer 特征点x坐标
          +++y Integer 特征点y坐标
          ++feature String 128维特征值base64编码信息
          ++reid_feature List 128维特征值Double列表
          +item_count Integer 识别的item个数
          上一篇
          全目标检测识别算子
          下一篇
          人脸比对算子