六派数据-人脸识别
  • ID

    98

  • 收藏

    1

  • 使用

    0

人脸识别

套餐
10000次
价格

  • 人脸检测

基本信息

  • 接口地址: http://open.liupai.net/facecompare/detect
  • 支持格式: JSON,JSONP
  • 请求方法: GET POST
  • 请求示例: http://open.liupai.net/facecompare/detect?appkey=yourappsecret
  • 接口备注: 检测图片中的人脸并标记出位置信息

请求参数 API在线测试

参数名称 类型 必填 说明
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最大。

请求代码 查看代码

  • PHP
  • JAVA
  • Python
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 "发送请求失败";

JSON返回示例

    数据信息

  • 今日调用: 41,750  次
  • 客服电话: 010-8639-9970
  • 客服邮箱: kf@ksmsoft.net
  • 售前客服:
  • 售后技术:

人脸识别问答专区

问答专区

相关资讯

其他推荐