功能描述
传入图片进行人脸检测和人脸分析,返回值是一段 JSON,可包含所识别到的人脸坐标、宽高、性别、年龄、Base64编码、人脸图片URL。
接口使用简单,提交识别图URL
即可返回人脸识别结果。
接口适用范围: 网站, 小程序, Android, iOS等, 提供各种方式解决方案, 一对一协助对接QQ: 445899710
图片要求
图片格式:JPG(JPEG),PNG
图片像素尺寸:最小 48*48 像素,最大 4096*4096 像素
图片文件大小:最大 2 MB
最小人脸像素尺寸: 系统能够检测到的人脸框为一个正方形,正方形边长的最小值为图像短边长度的 48 分之一,最小值不低于 48 像素。 例如图片为 4096*3200 像素,则最小人脸像素尺寸为 66*66 像素。
接口URL
https://www.pyingquan.com/api/detect
提交方式
POST
请求参数
是否必选 | 参数名 | 类型 | 说明 |
是 | appid | String | 调用此 API 的 API Key |
是 | appsecret | String | 调用此 API 的 API Secret |
是 | image_url | String | 识别图片的 URL |
否 | return_type | String | 返回方式,默认返回 人脸框左上角纵坐标(top),左上角横坐标(left),人脸框宽度(width),人脸框高度(height)。例如:70,80,100,100 值为: base64 时, 返回识别人脸的base64编码 值为: url 时, 返回识别人脸的在线图片URL |
返回值说明
字段 | 类型 | 说明 |
errcode | Int | 状态码 |
errmsg | String | 错误信息描述,当发生错误时才返回。 |
data | Array | 成功后返回的内容数组 |
┗ attributes | String | 根据人脸特征判断出的年龄、性别 |
┗ face_rectangle | String | 人脸矩形框的位置, base64编码, 图片URL |
成功返回示例
{"errcode":0,"data":[{"attributes":{"gender":"Female","age":23},"face_rectangle":{"width":67,"top":285,"left":482,"height":67,"url":"https:\/\/www.pyingquan.com\/upload\/2019043023574149016461.jpg"}}]}
错误返回示例
{ "errcode": 2001, "errmsg": "对应的图片未检测到人脸" }
errcode状态代码
状态代码 | 说明 |
0 | 识别成功 |
100 | 参数不完整 |
101 | appid或appsecret不正确 |
102 | 余额不足 |
2001 | 对应的图片未检测到人脸 |
2002 | 对应的客户上传的图像文件太大。本 API 要求图片文件大小不超过 2 MB |
2003 | 对应的图片 URL 错误或者无效 |
2004 | 对应的客户上传的图像像素尺寸太大或太小 |
2005 | 对应的图像无法正确解析 |
2006 | 传入的人脸框格式不符合要求,或者人脸框位于图片外 |
2007 | 下载图片超时 |
调用示例
$param = array( 'appid' => '', 'appsecret' => '', 'image_url' => 'https://wx4.sinaimg.cn/mw690/006gPk6Uly1g2evtgqt45j30j60i6jsv.jpg', 'return_type' => 'url', ); $snoopy = new \Snoopy(); $snoopy->submit('https://www.pyingquan.com/api/detect', $param); $json = json_decode($snoopy->results, true); }
价格
按量计费 0.02元/次
注册新账户会赠送1元,可用于测试。