超级简单的人脸识别接口, 根据图片URL返回人脸信息(坐标,宽高,人脸图URL, base64)

功能描述

传入图片进行人脸检测和人脸分析，返回值是一段 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.01元/次

注册新账户会赠送1元，可用于测试。