人脸识别（二）调用face++api实现人脸对比

上次博客简单讲了一下调用face++的api来检测人脸。当然，生产环境中要实现复杂的需求光靠这么简单的调用一下api肯定是不行的。这次先来讲一讲face++中实现人脸对比的api并实现一些相对较为复杂的需求。
首先来看一看调用的人脸对比的api需要的东西:
face++调用人脸对比api的网址：

• https://api-cn.faceplusplus.com/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-cn.faceplusplus.com/facepp/v3/compare";
//        创建参数队列    
        List 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 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();  
            }  
        }  
    }
}

这里用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-cn.faceplusplus.com:443] can be kept alive indefinitely
16:14:04.347 [main] DEBUG org.apache.http.impl.conn.PoolingHttpClientConnectionManager - Connection released: [id: 0][route: {s}->https://api-cn.faceplusplus.com: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}}
--------------------------------------

看看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-cn.faceplusplus.com/facepp/v3/faceset/create"; 
//        创建参数队列    
        List 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 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();  
            }  
        }  
    }
}

这里我只是将上面的代码修改了传入的参数，将url改为：https://api-cn.faceplusplus.com/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-cn.faceplusplus.com:443] can be kept alive indefinitely
17:18:04.581 [main] DEBUG org.apache.http.impl.conn.PoolingHttpClientConnectionManager - Connection released: [id: 0][route: {s}->https://api-cn.faceplusplus.com: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": []}
--------------------------------------

看到返回参数中faceset_token有值，就知道操作成功了。接下来我们把之前上传的图片加到faceset中，改变参数如下：

public static void main(String[] args) throws Exception {
//      设置网址
        String url = "https://api-cn.faceplusplus.com/facepp/v3/faceset/addface";
//        创建参数队列    
        List 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);
    }

将之前我添加的faceset的标识符myface_id传入，同时传入之前上传图片的face_token，请求完成得到一下参数：

Response content: {"faceset_token": "9cb520b964d58b3484565f6788ac750a", "time_used": 627, "face_count": 1, "face_added": 1, "request_id": "1514720178,9c0c43af-9923-461c-952e-f83f64f8f3e8", "outer_id": "myface_1", "failure_detail": []}

看到face_count为1代表当前这个faceset的存放照片个数，face_added为1表示成功添加了一个。至此，上传的照片就已经永久储存在了face++官方服务器上。

至此，生产环境需要的主要的api我已经讲的差不多了。本来计划讲一讲具体的业务的实现的，但由于时间有限，决定留到下次博客再讲，这里先把需要实现的业务给出来：

下次博客的时候就将这个需求实现一下。