人脸检测
Face++(cn.faceplusplus.com)人脸检测服务提供如下功能：人像检测功能；面部关键区域定位，如眼、鼻、嘴等；性别、年龄、微笑程度等属性分析。
Face++(cn.faceplusplus.com)人脸检测API提供如下功能：
人像检测功能；
面部关键区域定位，如眼、鼻、嘴等；
性别、年龄、微笑程度等属性分析。
实例代码：
$facedetection = apibus::init("facedetection");
$api = new apibus();
$facedetection = $api->load("facedetection");
$url = "https://cn.faceplusplus.com/wp-content/themes/faceplusplus.zh/assets/img/demo/1.jpg?v=5";
print_r($facedetection->detection($url, "age,gender,pose"));
- 分类：第三方服务
- 官方网站：
http://cn.faceplusplus.com
Methods
detection(GET)
参数
urlString
- 待检测图片的URL，原始图片大小需要小于3M
attributeString
- 可以是none或者由逗号分割的属性列表。默认为gender, age, race, smiling。目前支持的属性包括：gender, age, race, smiling, glass, pose, landmark
返回
返回示例
session_id string 相应请求的session标识符，可用于结果查询 url string 请求中图片的url img_id string Face++系统中的图片标识符，用于标识用户请求中的图片 face_id string 被检测出的每一张人脸都在Face++系统中的标识符 img_width integer 请求图片的宽度 img_height integer 请求图片的高度 face array 被检测出的人脸的列表 width float 0~100之间的实数，表示检出的脸的宽度在图片中百分比 height float 0~100之间的实数，表示检出的脸的高度在图片中百分比 center object 检出的人脸框的中心点坐标, x & y 坐标分别表示在图片中的 宽度和高度的百分比 (0~100之间的实数) eye_left object 相应人脸的左眼坐标，x & y 坐标分别表示在图片中的宽度和 高度的百分比 (0~100之间的实数) eye_right object 相应人脸的右眼坐标，x & y 坐标分别表示在图片中的宽度和 高度的百分比 (0~100之间的实数) mouth_left object 相应人脸的左侧嘴角坐标，x & y 坐标分别表示在图片中的宽 度和高度的百分比 (0~100之间的实数) mouth_right object 相应人脸的右侧嘴角坐标，x & y 坐标分别表示在图片中的宽 度和高度的百分比 (0~100之间的实数) nose object 相应人脸的鼻尖坐标，x & y 坐标分别表示在图片中的宽度和 高度的百分比 (0~100之间的实数) attribute object 包含一系列人脸的属性分析结果 gender object 包含性别分析结果，value的值为Male/Female, confidence 表示置信度 age object 包含年龄分析结果，value的值为一个非负整数表示估计的年龄, range表示估计年龄的正负区间 race object 包含人种分析结果，value的值为Asian/White/Black, confidence表示置信度 smiling object 包含微笑程度分析结果，value的值为0－100的实数，越大表示 微笑程度越高 glass object 包含眼镜佩戴分析结果，value的值为None/Dark/Normal, confidence表示置信度 pose object 包含脸部姿势分析结果，包括pitch_angle, roll_angle, yaw_angle，分别对应抬头，旋转（平面旋转），摇头。单位为角度。 landmark object 包含详细关键点分析结果，包含多个关键点的坐标。{ "face": [ { "attribute": { "age": { "range": 5, "value": 23 }, "gender": { "confidence": 99.9999, "value": "Female" }, "glass": { "confidence": 99.945, "value": "None" }, "landmark": { "left_eye_bottom": { "x": 43.3138, "y": 31.5582 }, "left_eye_center": { "x": 43.3692, "y": 30.8192 }, "left_eye_left_corner": { "x": 40.4904, "y": 30.526 }, "left_eye_pupil": { "x": 44.0898, "y": 30.4322 }, "left_eye_right_corner": { "x": 46.2482, "y": 31.1126 }, "left_eye_top": { "x": 43.5458, "y": 29.3306 }, "left_eyebrow_left_corner": { "x": 38.2864, "y": 26.5122 }, "left_eyebrow_right_corner": { "x": 46.6178, "y": 26.5594 }, "mouth_left_corner": { "x": 46.1326, "y": 44.9468 }, "mouth_lower_lip_bottom": { "x": 50.4616, "y": 47.447 }, "mouth_lower_lip_top": { "x": 50.0768, "y": 45.4286 }, "mouth_right_corner": { "x": 54.2592, "y": 44.6282 }, "mouth_upper_lip_bottom": { "x": 50.1606, "y": 44.6804 }, "mouth_upper_lip_top": { "x": 50.1434, "y": 43.5868 }, "nose_left": { "x": 46.8868, "y": 39.1006 }, "nose_right": { "x": 53.307, "y": 39.2382 }, "nose_tip": { "x": 49.9404, "y": 38.8484 }, "right_eye_bottom": { "x": 56.6594, "y": 31.9224 }, "right_eye_center": { "x": 56.5606, "y": 30.9886 }, "right_eye_left_corner": { "x": 53.9562, "y": 31.293 }, "right_eye_pupil": { "x": 56.3118, "y": 30.4256 }, "right_eye_right_corner": { "x": 59.165, "y": 30.6842 }, "right_eye_top": { "x": 56.9376, "y": 29.4638 }, "right_eyebrow_left_corner": { "x": 53.6446, "y": 27.1634 }, "right_eyebrow_right_corner": { "x": 61.6616, "y": 26.845 } }, "pose": { "pitch_angle": { "value": 17 }, "roll_angle": { "value": 0.735735 }, "yaw_angle": { "value": -2 } }, "race": { "confidence": 99.6121, "value": "Asian" }, "smiling": { "value": 4.86501 } }, "face_id": "17233b4b1b51ac91e391e5afe130eb78", "position": { "center": { "x": 49.4, "y": 37.6 }, "eye_left": { "x": 43.3692, "y": 30.8192 }, "eye_right": { "x": 56.5606, "y": 30.9886 }, "height": 26.8, "mouth_left": { "x": 46.1326, "y": 44.9468 }, "mouth_right": { "x": 54.2592, "y": 44.6282 }, "nose": { "x": 49.9404, "y": 38.8484 }, "width": 26.8 }, "tag": "" } ], "img_height": 500, "img_id": "22fd9efc64c87e00224c33dd8718eec7", "img_width": 500, "session_id": "38047ad0f0b34c7e8c6efb6ba39ed355", "url": "http://cn.faceplusplus.com/wp-content/themes/faceplusplus.zh/assets/img/demo/1.jpg?v=4" }错误返回示例
错误代码 HTTP 错误信息 1001 500 INTERNAL_ERROR 1003 403 AUTHORIZATION_ERROR 1003 403 INSUFFICIENT_PRIVILEGE_OR_QUOTA_LIMIT_EXCEEDED 1004 400 MISSING_ARGUMENTS 1005 400 INVALID_ARGUMENTS 1006 403 ILLEGAL_USE_OF_DEMO_KEY 1202 502 SERVER_TOO_BUSY 1301 431 IMAGE_ERROR_UNSUPPORTED_FORMAT 1302 432 IMAGE_ERROR_FAILED_TO_DOWNLOAD 1303 433 IMAGE_ERROR_FILE_TOO_LARGE 1304 434 IMAGE_ERROR 1502 452 BAD_TAG
{ "error": "AUTHORIZATION_ERROR", "error_code": 1003 }