最简单的人脸检测（免费调用百度AI开放平台接口）

远程调用百度AI开放平台的web服务，快速完成人脸识别
欢迎访问我的GitHub

这里分类和汇总了欣宸的全部原创(含配套源码)：https://github.com/zq2599/blog_demos

本篇概览

• 在检测人脸数量、位置、性别、口罩等场景时，可以考虑使用百度开放平台提供的web接口，一个web请求就能完成检测得到结果，本篇记录了从申请到真实调用的完整过程，由以下步骤组成：
  
  

注册百度账号

• 按照您的实际情况，注册个人或者企业账号，这个不多说了
  

登录百度智能云

• 使用刚才注册号的账号登录，地址是：https://login.bce.baidu.com/
  

实名认证

• 打开百度智能云的控制台：https://console.bce.baidu.com/
  
• 如下图，点击下图红框中的两个按钮，完成激活和实名认证：
  
  

创建应用

• 为了能够使用百度服务，需要创建一个应用
  
• 先选择类别，在控制台页面，操作如下图，点击红框四：
  
  
• 此刻已跳转到管理引用的页面，点击下图红框中的创建应用
  
  
• 为了免费使用百度的服务，先点击下图红框中的去领取：
  
  
• 在领取页面勾选人脸检测：
  
  
• 领取完成后，回到创建应用的页面，发现这些服务已经被勾选，如下图：
  
  
• 应用相关的信息填写完成后，提交表单即可完成创建应用
  

拿到API Key和Secret Key

• 在应用列表页面拿到API Key和Secret Key，这些都是调用百度服务的关键授权信息，如下图红框所示：
  
  

得到access_token

• 在使用百度提供的各种服务（如人脸检测）的时候，需要带上授权信息证明你有使用该服务的权限，这个授权信息就是access_token
  
• 最简单的方式就是curl命令获取
  

1. curl -i -k 'https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=【百度云应用的API Key】&client_secret=【百度云应用的Secret Key】'

复制代码

• 这里用postman尝试上述请求，如下图，红框中就是这次请求咱们要得到的access_token信息：
  
  
• 拿到access_token，就可以开始的调用百度的服务了，如下图，官方文档说了这个access_token的有效期是30天：
  
  
• 关于百度云授权信息的更多信息请在此查看：https://cloud.baidu.com/doc/FACE/s/Tkqahnjtk
  

编码

• 百度关于人脸检测的文档：https://ai.baidu.com/ai-doc/FACE/yk37c1u4t
  
• 人脸检测服务是个web接口，也能通过操作curl或者postman来完成，但是为了在代码中使用百度的服务，这里写一段代码来完成人脸检测
  
• 今天的项目是个普通的maven工程，没有使用spring或者spingboot框架，只有一些简单的java类和main方法
  
• 首先要在项目中引入下面三个库：
  

1. <dependency>
2.         <groupId>org.projectlombok</groupId>
3.     <artifactId>lombok</artifactId>
4.     <version>1.18.18</version>
5. </dependency>
7. <dependency>
8.         <groupId>com.squareup.okhttp3</groupId>
9.         <artifactId>okhttp</artifactId>
10.         <version>3.10.0</version>
11. </dependency>
13. <dependency>
14.         <groupId>com.fasterxml.jackson.core</groupId>
15.         <artifactId>jackson-databind</artifactId>
16.         <version>2.11.0</version>
17. </dependency>

复制代码

• 先新建一个对象FaceDetectRequest.java，用于保存请求参数：
  

1. package com.bolingcavalry.grabpush.bean.request;
3. import com.fasterxml.jackson.annotation.JsonProperty;
4. import lombok.Data;
6. /**
7. * @author willzhao
8. * @version 1.0
9. * @description 请求对象
10. * @date 2022/1/1 16:21
11. */
12. @Data
13. public class FaceDetectRequest {
14.     // 图片信息(总数据大小应小于10M)，图片上传方式根据image_type来判断
15.     String image;
17.     // 图片类型
18.     // BASE64:图片的base64值，base64编码后的图片数据，编码后的图片大小不超过2M；
19.     // URL:图片的 URL地址( 可能由于网络等原因导致下载图片时间过长)；
20.     // FACE_TOKEN: 人脸图片的唯一标识，调用人脸检测接口时，会为每个人脸图片赋予一个唯一的FACE_TOKEN，同一张图片多次检测得到的FACE_TOKEN是同一个。
21.     @JsonProperty("image_type")
22.     String imageType;
24.     // 包括age,expression,face_shape,gender,glasses,landmark,landmark150,quality,eye_status,emotion,face_type,mask,spoofing信息
25.     //逗号分隔. 默认只返回face_token、人脸框、概率和旋转角度
26.     @JsonProperty("face_field")
27.     String faceField;
29.     // 最多处理人脸的数目，默认值为1，根据人脸检测排序类型检测图片中排序第一的人脸（默认为人脸面积最大的人脸），最大值120
30.     @JsonProperty("max_face_num")
31.     int maxFaceNum;
33.     // 人脸的类型
34.     // LIVE表示生活照：通常为手机、相机拍摄的人像图片、或从网络获取的人像图片等
35.     // IDCARD表示身份证芯片照：二代身份证内置芯片中的人像照片
36.     // WATERMARK表示带水印证件照：一般为带水印的小图，如公安网小图
37.     // CERT表示证件照片：如拍摄的身份证、工卡、护照、学生证等证件图片
38.     // 默认LIVE
39.     @JsonProperty("face_type")
40.     String faceType;
42.     // 活体控制 检测结果中不符合要求的人脸会被过滤
43.     // NONE: 不进行控制
44.     // LOW:较低的活体要求(高通过率 低攻击拒绝率)
45.     // NORMAL: 一般的活体要求(平衡的攻击拒绝率, 通过率)
46.     // HIGH: 较高的活体要求(高攻击拒绝率 低通过率)
47.     // 默认NONE
48.     @JsonProperty("liveness_control")
49.     String livenessControl;
50.    
51.     // 人脸检测排序类型
52.     // 0:代表检测出的人脸按照人脸面积从大到小排列
53.     // 1:代表检测出的人脸按照距离图片中心从近到远排列
54.     // 默认为0
55.     @JsonProperty("face_sort_type")
56.     int faceSortType;
57. }

复制代码

• 其次是响应对象FaceDetectResponse.java：
  

1. package com.bolingcavalry.grabpush.bean.response;
3. import com.fasterxml.jackson.annotation.JsonProperty;
4. import lombok.Data;
5. import lombok.ToString;
7. import java.io.Serializable;
8. import java.util.List;
10. /**
11. * @author willzhao
12. * @version 1.0
13. * @description TODO
14. * @date 2022/1/1 13:30
15. */
16. @Data
17. @ToString
18. public class FaceDetectResponse implements Serializable {
19.     // 返回码
20.     @JsonProperty("error_code")
21.     String errorCode;
22.     // 描述信息
23.     @JsonProperty("error_msg")
24.     String errorMsg;
25.     // 返回的具体内容
26.     Result result;
28.     /**
29.      * @author willzhao
30.      * @version 1.0
31.      * @description 返回的具体内容
32.      * @date 2022/1/1 16:01
33.      */
34.     @Data
35.     public static class Result {
36.         // 人脸数量
37.         @JsonProperty("face_num")
38.         private int faceNum;
39.         // 每个人脸的信息
40.         @JsonProperty("face_list")
41.         List<Face> faceList;
43.         /**
44.          * @author willzhao
45.          * @version 1.0
46.          * @description 检测出来的人脸对象
47.          * @date 2022/1/1 16:03
48.          */
49.         @Data
50.         public static class Face {
51.             // 位置
52.             Location location;
53.             // 是人脸的置信度
54.             @JsonProperty("face_probability")
55.             double face_probability;
56.             // 口罩
57.             Mask mask;
59.             /**
60.              * @author willzhao
61.              * @version 1.0
62.              * @description 人脸在图片中的位置
63.              * @date 2022/1/1 16:04
64.              */
65.             @Data
66.             public static class Location {
67.                 double left;
68.                 double top;
69.                 double width;
70.                 double height;
71.                 double rotation;
72.             }
74.             /**
75.              * @author willzhao
76.              * @version 1.0
77.              * @description 口罩对象
78.              * @date 2022/1/1 16:11
79.              */
80.             @Data
81.             public static class Mask {
82.                 int type;
83.                 double probability;
84.             }
85.         }
86.     }
87. }

复制代码

• 这里有一处要注意：FaceDetectResponse对象中的字段是少于真实响应返回的字段的，这是因为这个demo不需要完整的返回内容，因此只要选择应用需要的字段定义在FaceDetectResponse.java中即可
  
• 最后是完整的服务类BaiduCloudService.java，如下所示，即读取图片 -> 转base64 -> 构造请求对象 -> 提交请求 -> 收到响应 -> 解析响应：
  

1. package com.bolingcavalry.grabpush.extend;
3. import com.bolingcavalry.grabpush.bean.request.FaceDetectRequest;
4. import com.bolingcavalry.grabpush.bean.response.FaceDetectResponse;
5. import com.fasterxml.jackson.databind.DeserializationFeature;
6. import com.fasterxml.jackson.databind.ObjectMapper;
7. import okhttp3.*;
8. import sun.misc.BASE64Encoder;
9. import java.io.FileInputStream;
10. import java.io.IOException;
11. import java.io.InputStream;
13. /**
14. * @author willzhao
15. * @version 1.0
16. * @description 百度云服务的调用
17. * @date 2022/1/1 11:06
18. */
19. public class BaiduCloudService {
21.     // 转换
22.     BASE64Encoder encoder = new BASE64Encoder();
24.     OkHttpClient client = new OkHttpClient();
26.     static final MediaType JSON = MediaType.parse("application/json; charset=utf-8");
28.     static final String URL_TEMPLATE = "https://aip.baidubce.com/rest/2.0/face/v3/detect?access_token=%s";
30.     String token;
32.     ObjectMapper mapper = new ObjectMapper();
34.     public BaiduCloudService(String token) {
35.         this.token = token;
36.         
37.         // 重要：反序列化的时候，字符的字段如果比类的字段多，下面这个设置可以确保反序列化成功
38.         mapper.disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
39.     }
41.     /**
42.      * 将指定位置的图片转为base64字符串
43.      * @param imagePath
44.      * @return
45.      */
46.     private String img2Base64(String imagePath) {
47.         InputStream inputStream = null;
48.         byte[] data = null;
50.         try {
51.             inputStream = new FileInputStream(imagePath);
52.             data = new byte[inputStream.available()];
53.             inputStream.read(data);
54.             inputStream.close();
55.         } catch (IOException ioException) {
56.             ioException.printStackTrace();
57.         }
59.         return null==data ? null :encoder.encode(data);
60.     }
62.     /**
63.      * 检测指定的图片
64.      * @param imageBase64
65.      * @return
66.      */
67.     public FaceDetectResponse detect(String imageBase64) {
68.         // 请求对象
69.         FaceDetectRequest faceDetectRequest = new FaceDetectRequest();
70.         faceDetectRequest.setImageType("BASE64");
71.         faceDetectRequest.setFaceField("mask");
72.         faceDetectRequest.setMaxFaceNum(6);
73.         faceDetectRequest.setFaceType("LIVE");
74.         faceDetectRequest.setLivenessControl("NONE");
75.         faceDetectRequest.setFaceSortType(0);
76.         faceDetectRequest.setImage(imageBase64);
78.         FaceDetectResponse faceDetectResponse = null;
80.         try {
81.             // 用Jackson将请求对象序列化成字符串
82.             String jsonContent = mapper.writeValueAsString(faceDetectRequest);
84.             //
85.             RequestBody requestBody = RequestBody.create(JSON, jsonContent);
86.             Request request = new Request
87.                     .Builder()
88.                     .url(String.format(URL_TEMPLATE, token))
89.                     .post(requestBody)
90.                     .build();
91.             Response response = client.newCall(request).execute();
92.             String rawRlt = response.body().string();
93.             faceDetectResponse = mapper.readValue(rawRlt, FaceDetectResponse.class);
94.         } catch (IOException ioException) {
95.             ioException.printStackTrace();
96.         }
98.         return faceDetectResponse;
99.     }
101.     public static void main(String[] args) {
102.         // 图片在本地的位置
103.         String imagePath = "E:\\temp\\202201\\01\\pic\\1.jpeg";
105.         // 百度云的token，是通过此接口得到的：https://aip.baidubce.com/oauth/2.0/token
106.         String token = "24.95xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.xxxxxxx.xxxxxxxxxx.xxxxxx-xxxxxxxx";
108.         // 实例化服务对象
109.         BaiduCloudService service = new BaiduCloudService(token);
111.         // 将图片转为base64字符串
112.         String imageBase64 = service.img2Base64(imagePath);
114.         // 向百度服务发请求，检测人脸
115.         FaceDetectResponse faceDetectResponse = service.detect(imageBase64);
117.         // 输出检测结果
118.         System.out.println(faceDetectResponse);
119.     }
120. }

复制代码

• 确保用于检测的照片与上述代码中的路径一致（E:\temp\202201\01\pic\1.jpeg），我这里选用了一张戴口罩的单人照，如下图：
  
  
• 执行BaiduCloudService的main方法，控制台将百度返回的检测结果打印出来，注意下面的内容并非JSON，而是lombok的@ToString注解拼接出的效果：
  
  
• 至此，通过百度的web接口调用人脸检测的实战已完成，可见有了云平台的支持，对于使用方来说开发过程变得非常简单
  

使用限制

• 既然是免费的，就很难十全十美，这样的web服务存在QPS限制，如下图，一秒钟不能超过两个，如果完成了企业认证，可以增加到十个，如果依旧不能满足需要，就只能付费了：
  
  

欢迎关注博客园：程序员欣宸

学习路上，你不孤单，欣宸原创一路相伴...

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！