人脸识别
人脸识别

人脸识别

接口类型：生活常用
接口状态：正常
描述：
  • 人脸检测

    • 接口地址：http://open.liupai.net/facecompare/detect

    支持格式：JSON,JSONP

    请求方式：GET POST

    请求示例：http://open.liupai.net/facecompare/detect?appkey=yourappsecret

    请求参数：

    参数名称 类型 必填 说明
    image file/string 是 图片信息(总数据大小应小于10M)，图片上传方式根据image_type来判断
    imageType 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,quality,eye_status,emotion,face_type信息 逗号分隔. 默认只返回face_token、人脸框、概率和旋转角度
    max_face_num string 否 最多处理人脸的数目，默认值为1，仅检测图片中面积最大的那个人脸；最大值10，检测图片中面积最大的几张人脸。
    face_type string 否 人脸的类型 LIVE表示生活照：通常为手机、相机拍摄的人像图片、或从网络获取的人像图片等IDCARD表示身份证芯片照：二代身份证内置芯片中的人像照片 WATERMARK表示带水印证件照：一般为带水印的小图，如公安网小图 CERT表示证件照片：如拍摄的身份证、工卡、护照、学生证等证件图片 默认LIVE
    liveness_control string 否 活体检测控制 NONE: 不进行控制 LOW:较低的活体要求(高通过率 低攻击拒绝率) NORMAL: 一般的活体要求(平衡的攻击拒绝率, 通过率) HIGH: 较高的活体要求(高攻击拒绝率 低通过率) 默认NONE

    返回参数：

    参数名称 类型 说明
    face_shape array 脸型，当face_field包含face_shape时返回
    type string square: 正方形 triangle:三角形 oval: 椭圆 heart: 心形 round: 圆形
    probability decimal 置信度，范围【0~1】，代表这是人脸形状判断正确的概率，0最小、1最大。
    gender array 性别，face_field包含gender时返回
    type string male:男性 female:女性
    probability decimal 性别置信度，范围【0~1】，0代表概率最小、1代表最大。
    glasses array 是否带眼镜，face_field包含glasses时返回
    type string none:无眼镜，common:普通眼镜，sun:墨镜
    probability decimal 眼镜置信度，范围【0~1】，0代表概率最小、1代表最大。
    eye_status array 双眼状态（睁开/闭合） face_field包含eye_status时返回
    left_eye decimal 左眼状态 [0,1]取值，越接近0闭合的可能性越大
    right_eye decimal 右眼状态 [0,1]取值，越接近0闭合的可能性越大
    emotionn int 情绪 face_field包含emotion时返回
    type string angry:愤怒 disgust:厌恶 fear:恐惧 happy:高兴 sad:伤心 surprise:惊讶 neutral:无情绪
    probability decimal 情绪置信度，范围0~1
    probability decimal 人种置信度，范围【0~1】，0代表概率最小、1代表最大。
    face_type array 真实人脸/卡通人脸 face_field包含face_type时返回
    type string human: 真实人脸 cartoon: 卡通人脸
    face_num int 检测到的图片中的人脸数量
    face_list string 人脸信息列表，具体包含的参数参考下面的列表。
    face_token string 人脸图片的唯一标识
    location array 人脸在图片中的位置
    left decimal 人脸区域离左边界的距离
    top decimal 人脸区域离上边界的距离
    width decimal 人脸区域的宽度
    height decimal 人脸区域的高度
    rotation int 人脸框相对于竖直方向的顺时针旋转角，[-180,180]
    face_probability decimal 人脸置信度，范围【0~1】，代表这是一张人脸的概率，0最小、1最大。
    angel array 人脸旋转角度参数
    yaw decimal 三维旋转之左右旋转角[-90(左), 90(右)]
    pitch decimal 三维旋转之俯仰角度[-90(上), 90(下)]
    roll decimal 平面内旋转角[-180(逆时针), 180(顺时针)]
    age int 年龄 ，当face_field包含age时返回
    beauty int 美丑打分，范围0-100，越大表示越美。当face_fields包含beauty时返回
    expression int 表情，当 face_field包含expression时返回
    type int none:不笑；smile:微笑；laugh:大笑
    probability int 表情置信度，范围【0~1】，0最小、1最大。

    JSON返回实例：