Java实现调用百度AI开放云平台(人脸识别API)
1.注册开发人员并查看官网API文档
网址：http://ai.baidu.com/docs
2.在管理中心创建应用及查看相关参数 AppID APIKey SecretKey都需要保存起来
3.开发测试
3.1、调用百度云人脸识别API需要两步
1、首先根据创建的应用，获取token，该token有效期为1个月。token的授权服务地址：https://aip.baidubce.com/oauth/2.0/token；
发送请求（推荐使用POST），并在URL中带上以下参数：
grant_type: 必须参数，固定为“client_credentials”；
client_id: 必须参数，应用的API Key；
client_secret: 必须参数，应用的Secret Key；
2、根据token调用api，服务地址：https://aip.baidubce.com/rest/2.0/face/v1/detect
具体实现代码如下：
package com.zmx.baiduaitest;
import org.apache.http.client.methods.CloseableHttpResponse;
import java.util.HashMap;
import java.util.Map;
/**
* Created by zhangwenchao on 2017/9/29.
*/
public class FaceAPITest {
public static void main(String[] args) {
// getToKenTest() ;
faceDetecttest();
}
//获取token
public static void getToKenTest(){
//使用其测试百度云API---获取token
//url: http://console.bce.baidu.com/ai
String APPID ="10201***"; //管理中心获得
//百度人脸识别应用apikey
String API_KEY = "WVsGWvDxyn55hW8P*******"; //管理中心获得
//百度人脸识别应用sercetkey
String SERCET_KEY = "z0uSr16LGyTNIMRRnP6f8jCL*****"; //管理中心获得
//百度人脸识别token 有效期一个月
String TOKEN = null;
String access_token_url = "https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials"
+"&client_id="+API_KEY +"&client_secret="+SERCET_KEY;
CloseableHttpResponse response = HttpClientUtils.doHttpsGet(access_token_url,null);
System.out.println(HttpClientUtils.toString(response));
//得到token = 24.1d786b9cdbdd8ac7cf55d56c7f38372b.2592000.1509244497.282335-10201425
}
//使用token调用API
public static void faceDetecttest(){
String token = "24.1d786b9cdbdd8ac7cf55d56c7f38372b.2592000.1509244497.282335-10201425";
String Filepath = "E:/test.jpg";
String image = Base64ImageUtils.GetImageStrFromPath(Filepath);
String url = "https://aip.baidubce.com/rest/2.0/face/v1/detect?access_token="+token;
Map headers = new HashMap();
headers.put("Content-Type", "application/x-www-form-urlencoded");
Map bodys = new HashMap();
bodys.put("image", image);
bodys.put("face_fields", "age,beauty,expression,gender,glasses,race,qualities");
try {
CloseableHttpResponse response = HttpClientUtils.doHttpsPost(url,headers,bodys);
System.out.println(HttpClientUtils.toString(response));
} catch (Exception e) {
e.printStackTrace();
}
}
} 上述用到了几个工具类如下：
HttpClientUtils.java：httpclient工具类用于发起get、post请求
package com.zmx.baiduaitest;
import org.apache.http.*;
import org.apache.http.client.CookieStore;
import org.apache.http.client.config.AuthSchemes;
import org.apache.http.client.config.CookieSpecs;
import org.apache.http.client.config.RequestConfig;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.client.protocol.HttpClientContext;
import org.apache.http.config.Registry;
import org.apache.http.config.RegistryBuilder;
import org.apache.http.conn.socket.ConnectionSocketFactory;
import org.apache.http.conn.socket.PlainConnectionSocketFactory;
import org.apache.http.conn.ssl.NoopHostnameVerifier;
import org.apache.http.conn.ssl.SSLConnectionSocketFactory;
import org.apache.http.cookie.Cookie;
import org.apache.http.impl.client.*;
import org.apache.http.impl.conn.PoolingHttpClientConnectionManager;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils;
import javax.net.ssl.SSLContext;
import javax.net.ssl.TrustManager;
import javax.net.ssl.X509TrustManager;
import java.io.IOException;
import java.security.KeyManagementException;
import java.security.NoSuchAlgorithmException;
import java.security.cert.CertificateException;
import java.security.cert.X509Certificate;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
import java.util.Map;
/**
* HttpClient4.5.X实现的工具类
* 可以实现http和ssl的get/post请求
*/
public class HttpClientUtils{
//创建HttpClientContext上下文
private static HttpClientContext context = HttpClientContext.create();
//请求配置
private static RequestConfig requestConfig = RequestConfig.custom()
.setConnectTimeout(120000)
.setSocketTimeout(60000)
.setConnectionRequestTimeout(60000)
.setCookieSpec(CookieSpecs.STANDARD_STRICT)
.setExpectContinueEnabled(true)
.setTargetPreferredAuthSchemes(Arrays.asList(AuthSchemes.NTLM, AuthSchemes.DIGEST))
.setProxyPreferredAuthSchemes(Arrays.asList(AuthSchemes.BASIC)).build();
//SSL的连接工厂
private static SSLConnectionSocketFactory socketFactory = null;
//信任管理器--用于ssl连接
private static TrustManager manager = new X509TrustManager() {
public void checkClientTrusted(X509Certificate[] x509Certificates, String s) throws CertificateException {
}
public void checkServerTrusted(X509Certificate[] x509Certificates, String s) throws CertificateException {
}
public X509Certificate[] getAcceptedIssuers() {
return null;
}
};
//ssl请求
private static void enableSSL() {
try {
SSLContext sslContext = SSLContext.getInstance("TLS");
sslContext.init(null, new TrustManager[]{manager}, null);
socketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
} catch (NoSuchAlgorithmException e) {
e.printStackTrace();
} catch (KeyManagementException e) {
e.printStackTrace();
}
}
/**
* https get请求
* @param url
* @param data
* @return
* @throws IOException
*/
public static CloseableHttpResponse doHttpsGet(String url, String data){
enableSSL();
Registry socketFactoryRegistry = RegistryBuilder.create()
.register("http", PlainConnectionSocketFactory.INSTANCE)
.register("https", socketFactory).build();
PoolingHttpClientConnectionManager connectionManager = new PoolingHttpClientConnectionManager(socketFactoryRegistry);
CloseableHttpClient httpClient = HttpClients.custom()
.setConnectionManager(connectionManager)
.setDefaultRequestConfig(requestConfig).build();
HttpGet httpGet = new HttpGet(url);
CloseableHttpResponse response = null;
try {
response = httpClient.execute(httpGet, context);
}catch (Exception e){
e.printStackTrace();
}
return response;
}
/**
* https post请求 参数为名值对
* @param url
* @param headers
* @param bodys
* @return
* @throws IOException
*/
public static CloseableHttpResponse doHttpsPost(String url, Map headers, Map bodys) {
enableSSL();
Registry socketFactoryRegistry = RegistryBuilder.create()
.register("http", PlainConnectionSocketFactory.INSTANCE)
.register("https", socketFactory).build();
PoolingHttpClientConnectionManager connectionManager = new PoolingHttpClientConnectionManager(socketFactoryRegistry);
CloseableHttpClient httpClient = HttpClients.custom()
.setConnectionManager(connectionManager)
.setDefaultRequestConfig(requestConfig).build();
HttpPost httpPost = new HttpPost(url);
for (Map.Entry e : headers.entrySet()) {
httpPost.addHeader(e.getKey(), e.getValue());
}
if (bodys != null) {
List nameValuePairList = new ArrayList();
for (String key : bodys.keySet()) {
nameValuePairList.add(new BasicNameValuePair(key, bodys.get(key)));
}
UrlEncodedFormEntity formEntity = new UrlEncodedFormEntity(nameValuePairList, Consts.UTF_8);
formEntity.setContentType("application/x-www-form-urlencoded; charset=UTF-8");
httpPost.setEntity(formEntity);
}
CloseableHttpResponse response = null;
try {
response = httpClient.execute(httpPost, context);
}catch (Exception e){}
return response;
}
/**
* https post请求 参数为名值对
* @param url
* @param values
* @return
* @throws IOException
*/
public static CloseableHttpResponse doHttpsPost(String url, List values) {
enableSSL();
Registry socketFactoryRegistry = RegistryBuilder.create()
.register("http", PlainConnectionSocketFactory.INSTANCE)
.register("https", socketFactory).build();
PoolingHttpClientConnectionManager connectionManager = new PoolingHttpClientConnectionManager(socketFactoryRegistry);
CloseableHttpClient httpClient = HttpClients.custom()
.setConnectionManager(connectionManager)
.setDefaultRequestConfig(requestConfig).build();
HttpPost httpPost = new HttpPost(url);
UrlEncodedFormEntity entity = new UrlEncodedFormEntity(values, Consts.UTF_8);
httpPost.setEntity(entity);
CloseableHttpResponse response = null;
try {
response = httpClient.execute(httpPost, context);
}catch (Exception e){}
return response;
}
/**
* http get
* @param url
* @param data
* @return
*/
public static CloseableHttpResponse doGet(String url, String data) {
CookieStore cookieStore = new BasicCookieStore();
CloseableHttpClient httpClient = HttpClientBuilder.create()
.setKeepAliveStrategy(new DefaultConnectionKeepAliveStrategy())
.setRedirectStrategy(new DefaultRedirectStrategy())
.setDefaultCookieStore(cookieStore)
.setDefaultRequestConfig(requestConfig).build();
HttpGet httpGet = new HttpGet(url);
CloseableHttpResponse response = null;
try {
response = httpClient.execute(httpGet, context);
}catch (Exception e){}
return response;
}
/**
* http post
*
* @param url
* @param values
* @return
*/
public static CloseableHttpResponse doPost(String url, List values) {
CookieStore cookieStore = new BasicCookieStore();
CloseableHttpClient httpClient = HttpClientBuilder.create()
.setKeepAliveStrategy(new DefaultConnectionKeepAliveStrategy())
.setRedirectStrategy(new DefaultRedirectStrategy())
.setDefaultCookieStore(cookieStore)
.setDefaultRequestConfig(requestConfig).build();
HttpPost httpPost = new HttpPost(url);
UrlEncodedFormEntity entity = new UrlEncodedFormEntity(values, Consts.UTF_8);
httpPost.setEntity(entity);
CloseableHttpResponse response = null;
try {
response = httpClient.execute(httpPost, context);
}catch (Exception e){}
return response;
}
/**
* 直接把Response内的Entity内容转换成String
*
* @param httpResponse
* @return
*/
public static String toString(CloseableHttpResponse httpResponse) {
// 获取响应消息实体
String result = null;
try {
HttpEntity entity = httpResponse.getEntity();
if (entity != null) {
result = EntityUtils.toString(entity,"UTF-8");
}
}catch (Exception e){}finally {
try {
httpResponse.close();
} catch (IOException e) {
e.printStackTrace();
}
}
return result;
}
public static void main(String[] args){
//使用其测试百度云API---获取token
//url: http://console.bce.baidu.com/ai
String APPID ="10201425"; //管理中心获得
//百度人脸识别应用apikey
String API_KEY = "WVsGWvDxyn55hW8P0UR8shbo"; //管理中心获得
//百度人脸识别应用sercetkey
String SERCET_KEY = "z0uSr16LGyTNIMRRnP6f8jCLMLXAYkIj"; //管理中心获得
//百度人脸识别token 有效期一个月
String TOKEN = null;
String access_token_url = "https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials"
+"&client_id="+API_KEY +"&client_secret="+SERCET_KEY;
CloseableHttpResponse response = HttpClientUtils.doHttpsGet(access_token_url,null);
System.out.println(HttpClientUtils.toString(response));
//得到token = 24.1d786b9cdbdd8ac7cf55d56c7f38372b.2592000.1509244497.282335-10201425
}
}
Base64ImageUtils.java:图片转换工具类，用于图片文件与base64数据格式图片进行互转
package com.zmx.baiduaitest;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import sun.misc.BASE64Decoder;
import sun.misc.BASE64Encoder;
/**
* Created by zhangwenchao on 2017/9/29.
* 本地或者网络图片资源转为Base64字符串
*/
public class Base64ImageUtils {
/**
* @Title: GetImageStrFromUrl
* @Description: 将一张网络图片转化成Base64字符串
* @param imgURL 网络资源位置
* @return Base64字符串
*/
public static String GetImageStrFromUrl(String imgURL) {
byte[] data = null;
try {
// 创建URL
URL url = new URL(imgURL);
// 创建链接
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
conn.setConnectTimeout(5 * 1000);
InputStream inStream = conn.getInputStream();
data = new byte[inStream.available()];
inStream.read(data);
inStream.close();
} catch (IOException e) {
e.printStackTrace();
}
// 对字节数组Base64编码
BASE64Encoder encoder = new BASE64Encoder();
// 返回Base64编码过的字节数组字符串
return encoder.encode(data);
}
/**
* @Title: GetImageStrFromPath
* @Description: (将一张本地图片转化成Base64字符串)
* @param imgPath
* @return
*/
public static String GetImageStrFromPath(String imgPath) {
InputStream in = null;
byte[] data = null;
// 读取图片字节数组
try {
in = new FileInputStream(imgPath);
data = new byte[in.available()];
in.read(data);
in.close();
} catch (IOException e) {
e.printStackTrace();
}
// 对字节数组Base64编码
BASE64Encoder encoder = new BASE64Encoder();
// 返回Base64编码过的字节数组字符串
return encoder.encode(data);
}
/**
* @Title: GenerateImage
* @Description: base64字符串转化成图片
* @param imgStr
* @param imgFilePath 图片文件名，如“E:/tmp.jpg”
* @return
*/
public static boolean saveImage(String imgStr,String imgFilePath) {
if (imgStr == null) // 图像数据为空
return false;
BASE64Decoder decoder = new BASE64Decoder();
try {
// Base64解码
byte[] b = decoder.decodeBuffer(imgStr);
for (int i = 0; i < b.length; ++i) {
if (b[i] < 0) {// 调整异常数据
b[i] += 256;
}
}
// 生成jpeg图片
OutputStream out = new FileOutputStream(imgFilePath);
out.write(b);
out.flush();
out.close();
return true;
} catch (Exception e) {
return false;
}
}
}
3.2、人脸识别API使用方法
功能：检测人脸美丑及年龄
官网：http://ai.baidu.com/docs#FACE官网文档
请求参数：
| 是否必选 | 类型 | 说明 | |
|---|---|---|---|
| image | 是 | string | base64编码后的图片数据，图片大小不超过2M。 |
| max_face_num | 否 | uint32 | 最多处理人脸数目，默认值1 |
| face_fields | 否 | string | 包括age,beauty,expression,faceshape,gender,glasses,landmark,race,qualities信息，逗号分隔，默认只返回人脸框、概率和旋转角度。 |
-
URL参数：
| 参数 | 值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
- Header如下：
| 参数 | 值 |
|---|---|
| Content-Type | application/x-www-form-urlencoded |
- Body中数据如下：
| 参数 | 值 |
|---|---|
| image | 图像base64编码 |
| max_face_num | 非必填，默认1 |
| face_fields | 非必填 |
3.3、返回JSON字符串内容解释
age 年龄 （目前官网还是没有说明年龄的误差范围）
beauty 美丑分数 0-100 越大值越美，如花识别年龄38 美丑评分21 表示不太合理
对于其他API也是同样的方式进行调用，相信大家都可以举一反三，今天项目用到一些复杂的API可以直接使用第三方提供的API，大体调用方式都类似。