上次博客简单讲了一下调用face++的api来检测人脸。当然，生产环境中要实现复杂的需求光靠这么简单的调用一下api肯定是不行的。这次先来讲一讲face++中实现人脸对比的api并实现一些相对较为复杂的需求。
首先来看一看调用的人脸对比的api需要的东西:
face++调用人脸对比api的网址：
https://api-/facepp/v3/compare
调用方法使用POST调用，需要传的主要的参数如下：
从官方给出的传参列表可以看出，api_key和api_secret无疑是必需要传的，接下来的必传的两个参数是两张图片。上传图片一共有三种方式：你可以选择上传图片的url，或者上传图片的二进制流，还可以上传以base64编码的图片数据。或者你假如不想上传图片，可以使用以前上传的图片直接比对。这时你只要提交以前上传图片后得到的face_token就行了。在之前我讲调用人脸检测的接口时，只要你上传成功，返回值里面就会带着face_token这个参数。这里值得一提的是，我们通过调用人脸检测上传的图片只会被face++官方储存一段时间然后删除，若我们想要将我们上传的照片长期保存在face++官方的库中，则需要调用FaceSet这个api，相当于在face++建立一个我们自己的图片仓库，将我们上传的图片存到里面。
这里先演示一个简单的例子：我先调用face++的人脸检测api（具体怎么调用的可以看我上一篇博客：调用人脸检测api地址），上传了两张图片，如下：
图片是我从网上随便找的（侵删）。上传之后得到两个face_token:72fc859abb56f7dc2c7d6e0700d251f8和90f86917d51c58dffc21c173fdfb7c7d，接着，我调用人脸对比的api，代码如下：
package com.example.demo;import java.io.IOException;import java.io.UnsupportedEncodingException;import java.util.ArrayList;import java.util.List;import org.apache.http.HttpEntity;import org.apache.http.client.ClientProtocolException;import org.apache.http.client.entity.UrlEncodedFormEntity;import org.apache.http.client.methods.CloseableHttpResponse;import org.apache.http.client.methods.HttpPost;import org.apache.http.impl.client.CloseableHttpClient;import org.apache.http.impl.client.HttpClients;import org.apache.http.message.BasicNameValuePair;import org.apache.http.util.EntityUtils;public class Compare {public static void main(String[] args) throws Exception {//设置网址String url = "https://api-/facepp/v3/compare";// 创建参数队列 List<BasicNameValuePair> formparams = new ArrayList<>(); formparams.add(new BasicNameValuePair("api_key", "your api key")); formparams.add(new BasicNameValuePair("api_secret", "your api secret")); formparams.add(new BasicNameValuePair("face_token1", "72fc859abb56f7dc2c7d6e0700d251f8")); formparams.add(new BasicNameValuePair("face_token2", "90f86917d51c58dffc21c173fdfb7c7d")); //发送请求post(formparams,url);}/** * 发送 post请求访问本地应用并根据传递参数不同返回不同结果 */ public static void post(List<BasicNameValuePair> formparams,String url) { // 创建默认的httpClient实例. CloseableHttpClient httpclient = HttpClients.createDefault(); // 创建httppost HttpPost httppost = new HttpPost(url); UrlEncodedFormEntity uefEntity; try { uefEntity = new UrlEncodedFormEntity(formparams, "UTF-8"); httppost.setEntity(uefEntity); System.out.println("executing request " + httppost.getURI()); CloseableHttpResponse response = httpclient.execute(httppost); try { HttpEntity entity = response.getEntity(); if (entity != null) { System.out.println("--------------------------------------"); System.out.println("Response content: " + EntityUtils.toString(entity, "UTF-8")); System.out.println("--------------------------------------"); } } finally { response.close(); } } catch (ClientProtocolException e) { e.printStackTrace(); } catch (UnsupportedEncodingException e1) { e1.printStackTrace(); } catch (IOException e) { e.printStackTrace(); } finally { // 关闭连接,释放资源 try { httpclient.close(); } catch (IOException e) { e.printStackTrace(); } } }}
123456789101112131415161718192223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
这里用java发了个http请求传入了api_key，api_secret,face_token1,face_token2四个参数。调用成功后返回结果如下：
--------------------------------------16:14:04.347 [main] DEBUG org.apache.http.impl.conn.PoolingHttpClientConnectionManager - Connection [id: 0][route: {s}->https://api-:443] can be kept alive indefinitely16:14:04.347 [main] DEBUG org.apache.http.impl.conn.PoolingHttpClientConnectionManager - Connection released: [id: 0][route: {s}->https://api-:443][total kept alive: 1; route allocated: 1 of 2; total allocated: 1 of 20]Response content: {"confidence": 67.485, "request_id": "1514708045,f3e7b3bd-015c-4189-a47c-88b32ef3a91a", "time_used": 585, "thresholds": {"1e-3": 62.327, "1e-5": 73.975, "1e-4": 69.101}}--------------------------------------
12345
看看response content里面返回的参数：
confidence：67.485。
含义：比对结果置信度，范围 [0,100]，小数点后3位有效数字，数字越大表示两个人脸越可能是同一个人。如果传入图片但图片中未检测到人脸，则无法进行比对，本字段不返回。
“request_id”: “1514708045,f3e7b3bd-015c-4189-a47c-88b32ef3a91a”
用于区分每一次请求的唯一的字符串。
“time_used”: 585
整个请求所花费的时间，单位为毫秒。
“thresholds”: {“1e-3”: 62.327, “1e-5”: 73.975, “1e-4”: 69.101}
一组用于参考的置信度阈值，包含以下三个字段。每个字段的值为一个 [0,100] 的浮点数，小数点后 3 位有效数字。
1e-3：误识率为千分之一的置信度阈值；1e-4：误识率为万分之一的置信度阈值；1e-5：误识率为十万分之一的置信度阈值；
如果置信值低于“千分之一”阈值则不建议认为是同一个人；如果置信值超过“十万分之一”阈值，则是同一个人的几率非常高。请注意：阈值不是静态的，每次比对返回的阈值不保证相同，所以没有持久化保存阈值的必要，更不要将当前调用返回的 confidence 与之前调用返回的阈值比较。如果传入图片但图片中未检测到人脸，则无法进行比对，本字段不返回。
用置信度阈值和置信度做对比我们可以得出这样的结果：置信度（67.485）达到了千分之一（62.327），但并未达到万分之一（69.101）和十万分之一（73.975）的阈值。所以可以认为两张照片有可能是同一个人，但可能性不高。
因为之前上传的图片不能永久保存，我先建立一个FaceSet,让后将这两张照片添加到faceset中去。创建faceset代码如下：
package com.example.demo;import java.io.IOException;import java.io.UnsupportedEncodingException;import java.util.ArrayList;import java.util.List;import org.apache.http.HttpEntity;import org.apache.http.client.ClientProtocolException;import org.apache.http.client.entity.UrlEncodedFormEntity;import org.apache.http.client.methods.CloseableHttpResponse;import org.apache.http.client.methods.HttpPost;import org.apache.http.impl.client.CloseableHttpClient;import org.apache.http.impl.client.HttpClients;import org.apache.http.message.BasicNameValuePair;import org.apache.http.util.EntityUtils;public class Compare {public static void main(String[] args) throws Exception {//设置网址String url = "https://api-/facepp/v3/faceset/create"; // 创建参数队列 List<BasicNameValuePair> formparams = new ArrayList<>(); formparams.add(new BasicNameValuePair("api_key", "your api key")); formparams.add(new BasicNameValuePair("api_secret", "your api secret")); formparams.add(new BasicNameValuePair("outer_id", "myface_1")); //发送请求post(formparams,url);}/** * 发送 post请求访问本地应用并根据传递参数不同返回不同结果 */ public static void post(List<BasicNameValuePair> formparams,String url) { // 创建默认的httpClient实例. CloseableHttpClient httpclient = HttpClients.createDefault(); // 创建httppost HttpPost httppost = new HttpPost(url); UrlEncodedFormEntity uefEntity; try { uefEntity = new UrlEncodedFormEntity(formparams, "UTF-8"); httppost.setEntity(uefEntity); System.out.println("executing request " + httppost.getURI()); CloseableHttpResponse response = httpclient.execute(httppost); try { HttpEntity entity = response.getEntity(); if (entity != null) { System.out.println("--------------------------------------"); System.out.println("Response content: " + EntityUtils.toString(entity, "UTF-8")); System.out.println("--------------------------------------"); } } finally { response.close(); } } catch (ClientProtocolException e) { e.printStackTrace(); } catch (UnsupportedEncodingException e1) { e1.printStackTrace(); } catch (IOException e) { e.printStackTrace(); } finally { // 关闭连接,释放资源 try { httpclient.close(); } catch (IOException e) { e.printStackTrace(); } } }}
1234567891011121314151617181922232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970
这里我只是将上面的代码修改了传入的参数，将url改为：https://api-/facepp/v3/faceset/create。除了一直要传入的api_key和api_secret外，还传入了outer_id这个参数，用来指定我的faceset的唯一标识，因为face++允许我们创建多个faceset,随意还是加一个唯一标识好点。返回参数如下：
--------------------------------------17:18:04.581 [main] DEBUG org.apache.http.impl.conn.PoolingHttpClientConnectionManager - Connection [id: 0][route: {s}->https://api-:443] can be kept alive indefinitely17:18:04.581 [main] DEBUG org.apache.http.impl.conn.PoolingHttpClientConnectionManager - Connection released: [id: 0][route: {s}->https://api-:443][total kept alive: 1; route allocated: 1 of 2; total allocated: 1 of 20]Response content: {"faceset_token": "9cb520b964d58b3484565f6788ac750a", "time_used": 110, "face_count": 0, "face_added": 0, "request_id": "1514711886,953de53f-9c22-4aca-904f-2ffff88761a1", "outer_id": "myface_1", "failure_detail": []}--------------------------------------
12345
看到返回参数中faceset_token有值，就知道操作成功了。接下来我们把之前上传的图片加到faceset中，改变参数如下：
public static void main(String[] args) throws Exception {//设置网址String url = "https://api-/facepp/v3/faceset/addface";// 创建参数队列 List<BasicNameValuePair> formparams = new ArrayList<>(); formparams.add(new BasicNameValuePair("api_key", "your api key")); formparams.add(new BasicNameValuePair("api_secret", "your api secret")); formparams.add(new BasicNameValuePair("outer_id", "myface_1")); formparams.add(new BasicNameValuePair("face_tokens", "72fc859abb56f7dc2c7d6e0700d251f8")); //发送请求post(formparams,url);}
123456789101112
将之前我添加的faceset的标识符myface_id传入，同时传入之前上传图片的face_token，请求完成得到一下参数：
Response content: {"faceset_token": "9cb520b964d58b3484565f6788ac750a", "time_used": 627, "face_count": 1, "face_added": 1, "request_id": "151478,9c0c43af-9923-461c-952e-f83f64f8f3e8", "outer_id": "myface_1", "failure_detail": []}
1
看到face_count为1代表当前这个faceset的存放照片个数，face_added为1表示成功添加了一个。至此，上传的照片就已经永久储存在了face++官方服务器上。
至此，生产环境需要的主要的api我已经讲的差不多了。本来计划讲一讲具体的业务的实现的，但由于时间有限，决定留到下次博客再讲，这里先把需要实现的业务给出来：
下次博客的时候就将这个需求实现一下。
转自：/zoroduyu/article/details/78940948
