智能门禁(7)----调用face++api实现人脸对比 人脸识别(二)调用face++api实现人脸对比

人脸识别(二)调用face++api实现人脸对比

首先来看一看调用的人脸对比的api需要的东西: 
face++调用人脸对比api的网址:

调用方法使用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<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();  
            }  
        }  
    }
}
  • 这里用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<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();  
            }  
        }  
    }
}
  • 这里我只是将上面的代码修改了传入的参数,将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<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);
    }
  • 将之前我添加的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": []}
  • 1

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

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

这里写图片描述

首先来看一看调用的人脸对比的api需要的东西: 
face++调用人脸对比api的网址:

调用方法使用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<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();  
            }  
        }  
    }
}
  • 这里用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<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();  
            }  
        }  
    }
}
  • 这里我只是将上面的代码修改了传入的参数,将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<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);
    }
  • 将之前我添加的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": []}
  • 1

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

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

这里写图片描述

猜你喜欢

转载自blog.csdn.net/zhangbijun1230/article/details/81031250