参数名称 | 类型 | 必填 | 说明 |
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最大。 |
require_once("curl.func.php"); $method = "POST"; $url = "http://open.liupai.net/facecompare/detect"; $headers = NULL; $params = array( "appkey" => "yourappsecret", "image" => "参数1", "imageType " => "参数2", "face_field" => "参数3", "max_face_num" => "1", "face_type" => "参数5", "liveness_control" => "参数6" ); $result = api_curl($method, $url, $headers, $params); if ($result) { $body = json_decode($result["body"], TRUE); $status_code = $body["status"]; if ($status_code == "200") { var_dump($body["result"]); }else var_dump($body); }else echo "发送请求失败";