人脸检测服务

服务说明

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

接口说明

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

价格

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

接口地址

http://g.sae.sina.com.cn/ocr/

签名规则

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

请求方式

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代码可以从这里点击下载