文档中心

简介

HI，您好，欢迎使用腾讯AI开放平台多人脸检测API接口服务。

本文档主要针对需要集成HTTP API的技术研发工程师，详细描述多人脸检测能力相关的技术内容。

如果您对文档内容有任何疑问，可以通过以下几种方式联系我们：

官方交流一群：581197347

官方交流二群：705874401

官方交流三群：415349651

联系邮箱：[e-mail]

接口能力

接口名称	接口描述	API地址
多人脸检测	识别上传图像上面的人脸位置，支持多人脸识别。	https://api.ai.qq.com/fcgi-bin/face/face_detectmultiface

更多更强大的接口能力正在开发中，并逐步开放，敬请期待！

协议须知

调用方集成多人脸检测API时，请遵循以下规则。

规则	描述
传输方式	HTTPS
请求方法	POST
字符编码	统一采用UTF-8编码
响应格式	统一采用JSON格式
接口鉴权	签名机制，详情请阅接口鉴权

多人脸检测接口

1. 接口描述

检测图片中的人脸位置，可以识别出一张图片上的多个人脸。

2. 请求参数

参数名称	是否必选	数据类型	数据约束	示例数据	描述
app_id	是	int	正整数	1000001	应用标识（AppId）
time_stamp	是	int	正整数	1493468759	请求时间戳（秒级）
nonce_str	是	string	非空且长度上限32字节	fa577ce340859f9fe	随机字符串
sign	是	string	非空且长度固定32字节		签名信息，详见接口鉴权
image	是	string	原始图片的base64编码数据（原图大小上限1MB）	...	待识别图片

3. 响应参数

参数名称	是否必选	数据类型	描述
ret	是	int	返回码； 0表示成功，非0表示出错
msg	是	string	返回信息；ret非0时表示出错时错误原因
data	是	object	返回数据；ret为0时有意义
+ face_list	是	array	被检测出的人脸列表
+ + x1	是	float	人脸框左上角x
+ + y1	是	float	人脸框左上角y
+ + x2	是	float	人脸框右下角x
+ + y2	是	float	人脸框右下角y

4. 请求限制

单用户单接口的QPS（每秒请求次数）上限如下，如需更多请联系QQ客服反馈。

未认证用户	个人认证用户	企业认证用户
1	2	10

5. 参考示例

假设示例请求数据如下。

参数名称	参数数据	描述
app_id	1000001	仅供参考
image		实时计算base64
time_stamp		实时计算
nonce_str		实时计算
sign		实时计算

假设应用密钥为：a95eceb1ac8c24ee28b70f7dbba912bf，示例图片文件存储路径为：/path/to/image。

下面使用PHP实现该HTTP API调用，其中getReqSign、doHttpPost可以从接口鉴权获取。

// 图片base64编码
$path   = '/path/to/image';
$data   = file_get_contents($path);
$base64 = base64_encode($data);

// 设置请求数据
$appkey = 'a95eceb1ac8c24ee28b70f7dbba912bf';
$params = array(
    'app_id'     => '1000001',
    'image'      => $base64,
    'time_stamp' => strval(time()),
    'nonce_str'  => strval(rand()),
    'sign'       => '',
);
$params['sign'] = getReqSign($params, $appkey);

// 执行API调用
$url = 'https://api.ai.qq.com/fcgi-bin/face/face_detectmultiface';
$response = doHttpPost($url, $params);
echo $response;

上述echo $response的输出结果即API的响应结果（注意使用UTF-8编码）：

{
    "ret": 0,
    "msg": "ok",
    "data": {
        "face_list": [
            {
                "x1": 388.75,
                "y1": 140.274,
                "x2": 515.03,
                "y2": 284.036
            },
            {
                "x1": 298.597,
                "y1": 175.583,
                "x2": 397.832,
                "y2": 294.083
            }
        ]
    }
}