人脸识别(二)调用face++api实现人脸对比
上次博客简单讲了一下调用face++的api来检测人脸。当然,生产环境中要实现复杂的需求光靠这么简单的调用一下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();
}
}
}
}
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
- 45
- 46
- 47
- 48
- 49
- 50
- 51
- 52
- 53
- 54
- 55
- 56
- 57
- 58
- 59
- 60
- 61
- 62
- 63
- 64
- 65
- 66
- 67
- 68
- 69
- 70
- 71
这里用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}}
--------------------------------------
- 1
- 2
- 3
- 4
- 5
看看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();
}
}
}
}
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
- 45
- 46
- 47
- 48
- 49
- 50
- 51
- 52
- 53
- 54
- 55
- 56
- 57
- 58
- 59
- 60
- 61
- 62
- 63
- 64
- 65
- 66
- 67
- 68
- 69
- 70
这里我只是将上面的代码修改了传入的参数,将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": []}
--------------------------------------
- 1
- 2
- 3
- 4
- 5
看到返回参数中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);
}
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
将之前我添加的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我已经讲的差不多了。本来计划讲一讲具体的业务的实现的,但由于时间有限,决定留到下次博客再讲,这里先把需要实现的业务给出来:
下次博客的时候就将这个需求实现一下。
上一篇: 【百度大脑新品体验】车牌识别
下一篇: 人脸识别之人脸对比 【C#】