人脸识别

功能描述

传入图片进行人脸检测和人脸分析，返回值是一段 JSON，可包含所识别到的人脸坐标、宽高、性别、年龄、Base64编码、人脸图片URL。
接口使用简单，提交识别图URL即可返回人脸识别结果。

接口适用范围: 网站, 小程序, Android, iOS等, 提供各种方式解决方案, 一对一协助对接QQ: 445899710

图片要求

图片格式：JPG(JPEG)，PNG
图片像素尺寸：最小 4848 像素，最大 40964096 像素
图片文件大小：最大 2 MB
最小人脸像素尺寸：系统能够检测到的人脸框为一个正方形，正方形边长的最小值为图像短边长度的 48 分之一，最小值不低于 48 像素。例如图片为 40963200 像素，则最小人脸像素尺寸为 6666 像素。

价格

按量计费 0.01元/次

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

请求参数

Query 参数

appid

string

必需

调用此 API 的 API Key

示例值:

123456

appsecret

string

必需

调用此 API 的 API Secret

示例值:

123456

image_url

string

识别图片的 URL

必需

return_type

string

可选

返回方式，默认返回人脸框左上角纵坐标（top），左上角横坐标（left），人脸框宽度（width），人脸框高度（height）。例如：70,80,100,100
值为: base64 时, 返回识别人脸的base64编码
值为: url 时, 返回识别人脸的在线图片URL

示例值:

模板变量内容

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

data

array [object {2}]

必需

attributes

object

可选

face_rectangle

object

可选

示例

{
    "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" //头像图片
            }
        }
    ]
}

⚪100参数不完整

⚪101 appid或appsecret不正确

⚪102余额不足

⚪1001模板图没有识别到人脸

⚪2001对应的图片未检测到人脸

⚪2002 对应的客户上传的图像文件太大。本 API 要求图片文件大小不超过 2 MB

⚪2003对应的图片 URL 错误或者无效

⚪2004对应的客户上传的图像像素尺寸太大或太小

⚪2005对应的图像无法正确解析

⚪2006传入的人脸框格式不符合要求，或者人脸框位于图片外

⚪2007下载图片超时

功能描述#

图片要求#

价格#

请求参数

示例代码

返回响应

功能描述

图片要求

价格