# 人脸检测服务

# 服务说明

检测图像中是否有人脸，返回检测到的人脸的数目和人脸区域的矩形框坐标。

# 接口说明

此接口为同步接口，调用后实时返回结果。

# 价格

2云豆/次调用，0.02元/次。

# 接口地址

http://g.sae.sina.com.cn/ocr/ (opens new window)

# 签名规则

查询需要签名，签名规则请参考签名规则章节。

# 请求方式

POST

# 请求参数列表

参数	说明	是否必选	样例
img	经base64编码的图像内容	是	可以是jpg、png、bmp，不支持gif等动态图格式
img_name	图像文件名	是	当前处理图像的文件名，用于校验

# 调用示例

原图如下：

成功识别时，接口返回如下的JSON格式的文本：

{
	"code": 1000,
	"face_num": 2,
	"facelist": [
		[143, 21, 347, 278, 1.0],
		[396, 189, 425, 224, 0.9921]
	],
	"img_name": "1.jpg",
	"message": ""
}

# 返回值说明

参数	含义	备注
code	返回结果状态码	1000，成功检测到人脸 1001，没有检测到人脸，facelist为空[] 1021，传图失败，详情请参考message 1022，人脸检测失败，详情请参考message 1023，图像解码失败，可能是gif图像被错误的命名为*.jpp图像，此API不支持动图格式
message	调用错误的文字描述
face_num	检测到人脸的数目
facelist	原始图像坐标系中人脸区域的位置的列表及判定的分值	[[x1, y1, x2, y2, score]]
img_name	图片文件名	用户请求图像的文件名,用于校验

# PHP调用示例

<?php
require(dirname(__FILE__).'/gapi.php');

use sinacloud\sae\Gapi;
$i = new Gapi('ACCESSKEY', 'SECRETKEY');
$post_data = array();
$post_data['img_name'] = '1.jpg';
$post_data['img'] = base64_encode(file_get_contents('1.jpg'));
$ret = $i->post('/facedetection/', $post_data);
echo($ret);

调用完成后，接口会返回：

{
	"code": 1000,
	"face_num": 2,
	"facelist": [
		[143, 21, 347, 278, 1.0],
		[396, 189, 425, 224, 0.9921]
	],
	"img_name": "1.jpg",
	"message": ""
}

以上demo代码可以从这里点击下载。