眼神ABIS平台API:人脸计数
人脸计数识别,对传入图像作人脸计数识别;可用于人流量统计、人员聚集等场景识别
功能描述
人脸计数识别,对传入图像作人脸计数识别,将检测结果以JSON格式返回给调用者。
接口调用
人脸计数识别,对传入图像作人脸计数识别,将检测结果以JSON格式返回给调用者。
- 请求方法
http://${IP}:${Port}/v1/detect/imagefacecount?code=PERSON_FACE_COUNT
- Header参数
Key | Value | 请求或响应 |
---|---|---|
Content-type | application/json | 存在于请求和响应中,不可为空 |
Abis-Request-Sequence | 请求流水号 | 存在于请求和响应中,请求中可以为空,如为空则由服务自动生成一个流水号 |
Authorization | 接口鉴权标识 | 若使用ABIS云平台的接口API,则需要去 ABIS门户控制台-基本资料-鉴权密钥 中获取 立即获取 |
- Body参数
Json Path | 类型 | 必填 | 含义 | 注意事项 |
---|---|---|---|---|
$.image.content | String | 是 | Base64 编码的图像数据 | 图片保证清晰可见,同时图片大小适中 |
对应示例:
{
"image": {
"content": "/9j/4A0Hyc5PTgyAFFFFAFFFFoooAooooAooooAqBnzFFFATUEAnNFFATRRRQBRRRQBRRRQBRRRQBRRRQBRRRQBRRRQBRRRQEZooooSz//2Q=="
}
}
- 返回参数
Json Path | 类型 | 含义 | 注意事项 |
---|---|---|---|
$.response.status | String | 返回状态 | 2000 表示正常 |
$.reply.faceCount | Int | 人脸个数 |
对应示例:
{
"reply": {
"faceCount": 1
},
"response": {
"status": "2000"
}
}
错误码
错误码 | 说明 | 解决方案 |
---|---|---|
2000 | 成功 | |
-2001 | 未知的异常 | 请查看返回的 content 中内容 |
-2020 | 传入图片内容为空 | 请确定是否传入了图片 |
-2021 | 加载图片失败 | 传入的不是有效图片或不支持的图片格式,支持的图片格式包括:BMP/JPG/TIF/PNG/WSQ/JP2/JPC/J2K/TFF |
-2100 | 未检测到人脸 | 请确保图片是正面朝上的人脸图片,且人脸清晰,图片背景没有反光 |
-2101 | 检测人脸属性异常 | 详情请查看后台日志 |
-2102 | 接口调用超时 | 可能是请求量过大,或者可能是服务器上cpu被其他应用占用过大 |
-2108 | 文件读取失败 | 请查看 content 字段返回的异常信息 |
-2109 | 算法调用图像质量检测接口失败 | 请查看算法错误码文档 |
-2119 | 人脸属性检测的条件参数未设置 | 请输入需要检测的人脸属性参数 |
注意事项
1、对图像要求
支持的图片格式:BMP/JPG/TIF/PNG/WSQ/JP2/JPC/J2K/TFF
对比度、亮度适中;
尽量不要有较多背景,尽量选择浅色、纯色背景;
图像尽量避免反光和黑影;
图像清晰,避免图像模糊不清; 图像分辨率不宜过高,一方面造成图片过大,不利于传输,一方面分辨率过高也会影响识别率。
人脸图片中,人脸宽度不低于60像素
2、服务需要联网调用
由于当前服务基于 http 技术实现,用户调用服务前请确保您的设备可以连通服务器,并保证一定的带宽。否则图像数据网络传输较慢,会引起较长时间等待。
3、Base64编码
若接口涉及到数据需要进行base64编码,请引用commons-codec-1.13.jar对图片进行base64编码:base64.encodeBase64String(byteData);
示例代码(Java)
package cn.eyecool;
import java.awt.image.BufferedImage;
import java.io.ByteArrayOutputStream;
import java.io.File;
import java.io.IOException;
import java.net.MalformedURLException;
import javax.imageio.ImageIO;
import org.apache.commons.codec.binary.Base64;
import org.apache.http.client.config.RequestConfig;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
import com.alibaba.fastjson.JSON;
import lombok.AllArgsConstructor;
import lombok.Data;
/**
* 人脸计数原子能力调用Demo
*
* @author mawj
* @date 2023/03/09
*/
public class DetectFaceCountDemo {
// 连接超时时间
private static int connTimeOut = 60 * 1000;
// 请求原子能力的URL(实际开发调试中,可以换成自己部署的abis服务)
private static final String url = "https://www.abis.cn/v1/detect/imagefacecount";
// 待检测图片的本地路径
private static String imgPath = System.getProperty("user.dir") + File.separator + "image";
public static void main(String[] args) {
// 读取本地图片
File leftImageFile = new File(imgPath + File.separator + "face1.jpg");
// 组装数据结构
DetectFaceCountDemo demo = new DetectFaceCountDemo();
ImageFaceCountParam param = demo.new ImageFaceCountParam();
param.setImage(demo.new ImageContent(encodeImgageToBase64(leftImageFile)));
// 发送Http请求
String response = doPostJson(url, JSON.toJSONString(param));
System.out.println("响应数据:");
System.out.println(response);
}
/**
* 请求参数
*
* @date 2022/05/25
*/
@Data
class ImageFaceCountParam {
/**
* 图像信息
*/
private ImageContent image;
}
/**
* 图片内容
*
* @date 2022/05/25
*/
@Data
@AllArgsConstructor
class ImageContent {
/**
* 图像Base64
*/
private String content;
}
/**
* File文件转base64格式
*
* @param imageFile
* @return string
*/
public static String encodeImgageToBase64(File imageFile) {
ByteArrayOutputStream outputStream = null;
try {
BufferedImage bufferedImage = ImageIO.read(imageFile);
outputStream = new ByteArrayOutputStream();
ImageIO.write(bufferedImage, "jpg", outputStream);
} catch (MalformedURLException e1) {
e1.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
// 返回Base64编码过的字节数组字符串
return Base64.encodeBase64String(outputStream.toByteArray());
}
/**
* PostJson请求
*
* @param url
* @param json
* @return
*/
public static String doPostJson(String url, String json) {
// 创建Httpclient对象
CloseableHttpClient httpClient = HttpClients.createDefault();
CloseableHttpResponse response = null;
String resultString = "";
// TODO 此处token的值需要修改,从网页端获取,格式为:Bearer token
String token = "Bearer eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6ImYxYzU4MGZhLTUyZjctNDE4OS04MGE4LWQ4ZjYyYWFiMmEwMCJ9.ZhWKCU0Xr7O8-cTv34FkkZUrb28WoBzPmOAnbvIrjB65kW6DUso-KB8WgAagSvYHF5McWS8Bl2_NsrikYFDxpw";
try {
// 创建Http Post请求
HttpPost httpPost = new HttpPost(url);
httpPost.setHeader("Authorization",token);
/** 设置超时时间 */
RequestConfig requestConfig = RequestConfig.custom().setConnectionRequestTimeout(connTimeOut)
.setSocketTimeout(connTimeOut).setConnectTimeout(connTimeOut).build();
// 创建请求内容
StringEntity entity = new StringEntity(json, ContentType.APPLICATION_JSON);
httpPost.setEntity(entity);
httpPost.setConfig(requestConfig);
// 执行http请求
response = httpClient.execute(httpPost);
resultString = EntityUtils.toString(response.getEntity(), "utf-8");
} catch (Exception e) {
e.printStackTrace();
} finally {
finallyClose(httpClient, response);
}
return resultString;
}
/**
* 关闭和释放
*
* @param httpClient
* @param response
*/
private static void finallyClose(CloseableHttpClient httpClient, CloseableHttpResponse response) {
try {
if (response != null) {
response.close();
}
httpClient.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
更多推荐
所有评论(0)