干貨 | AI人臉識別之人臉搜索

本文檔將利用京東雲AI SDK來實踐人臉識別中的人臉搜索功能，主要涉及到分組創建/刪除、分組列表獲取、人臉創建/刪除、人臉搜索，本次實操的最終效果是：創建一個人臉庫，拿一張圖片在人臉庫中搜索出相似度最高的一張，實現1：N的人臉識別，操作示意圖如下：

一、准備工作

1. 創建AK/SK

登陸京東雲控制台：https://console.jdcloud.com，點擊右上角賬戶AccessKey 管理，接着如圖點擊創建Access Key

2. 購買人臉搜索服務

人臉搜索通過 API 調用次數計費，目前人臉搜索功能有0元免費試用，調用量限制為13

我們登陸到京東雲控制台，依次點擊左側導航人工智能-人臉識別-人臉搜索，點擊立即購買完成購買操作。

3.下載SDK

購買完成后，返回人臉搜索的控制台，如圖點擊下載SDK完成京東雲AI SDK的下載操作

4.下載Eclipse並安裝

Eclipse下載地址：https://www.eclipse.org/downloads/，Eclipse安裝方法請自行百度。

二、實操開始

1.新建JAVA項目

打開Eclipse，依次點擊File-New-Java Project，輸入Project name如下圖設置后，點擊Finish-Don't Create

右擊JAVA項目中的src目錄，依次點擊new-Package

接下來我們分別創建分組創建（faceGroupCreate）/刪除（faceGroupDelete）、分組列表獲取（getFaceGroupList）、人臉創建（faceCreate）/刪除（faceDelete）、人臉搜索（faceSearch）相關的（類）Class，新建Class的方法如下：

全部Class創建完成后如下圖：

2.裝載京東雲AI SDK

將我們下載好的京東雲AI SDK解壓，然后復制到我們新建的JAVA項目的根目錄里

刷新Eclipse中的Package Explorer便可看到我們復制進來的京東雲AI SDK文件，選中全部jar包文件，右擊，依次點擊Build Path-Add to Build Path來重新構建路徑（Build Path）

重新構建路徑完成后，我們在Eclipse的Package Explorer中可看到Referenced Libraries，里面包含我們重構路徑的所有jar包

3.調試接口

創建分組（faceGroupCreate）

在faceGroupCreate類中輸入如下內容作為調試代碼

 package facesearch;
 
 import com.jdcloud.apigateway.signature.JdcloudSDKClient;
 import com.jdcloud.sdk.utils.BinaryUtils;
 import com.google.api.client.http.HttpResponse;
 import java.io.IOException;
 import java.util.HashMap;
 import java.util.Map;
 
import static com.jdcloud.sdk.http.Protocol.HTTP;

//創建分組
public class faceGroupCreate {
    public static void main(String[] args) {
        String accessKey = "請輸入您的AK";
        String secretKey = "請輸入您的SK";
        String endPoint = "aiapi.jdcloud.com";
        String path = "/jdai/faceGroupCreate";
        String method = "POST";
        Map<String, String> headers = new HashMap<>();
        Map<String, Object> queryMap = new HashMap<>();
        //queryMap.put("groupId", "10");
        queryMap.put("groupName", "請輸入分組名稱");
        queryMap.put("groupInfo", "請輸入分組描述");
        String body = "\"\"";
        try {
            HttpResponse response = JdcloudSDKClient.execute(accessKey, secretKey, HTTP,
                endPoint, path, method, headers, queryMap, body);
            System.out.println(new String(BinaryUtils.toByteArray(response.getContent())));
        } catch (IOException e) {
            System.out.println(e.getMessage());
        }
    }
}

右擊代碼依次點擊Run as-1 Java Application運行代碼

運行后發現報錯信息如下（這里雖然有報錯，但我們定義的名稱為請輸入分組名稱的組已成功創建）：

SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

由此我們可以看出，報出錯誤的地方主要是slf4j的jar包，而故障碼中Failed to load class "org.slf4j.impl.StaticLoggerBinder"的意思則是加載類文件org.slf4j.impl.StaticLoggerBinder時失敗

我們下載slf4j-nop.jar，然后像添加AI SDK jar包一樣添加到build path中即可解決問題，slf4j-nop.jarjar包我已打包上傳到京東雲對象存儲，下載地址為：https://pocenv-hcc.s3.cn-north-1.jdcloud-oss.com/slf4j-nop-1.7.28.jar

將slf4j包下載后復制到京東雲AI SDK文件夾里，然后在Eclipse內添加到構建路徑里即可

接下來依次創建其他類文件

注意： 如下代碼中涉及到String body = "imageBase64=";的部分

• 需要先將圖片轉換為Base64，轉換地址為：http://imgbase64.duoshitong.com/；
• 然后將轉換后的代碼復制到imageBase64=之后（轉換后的代碼需去除掉“data:image/jpeg;base64,”后再復制）。

刪除分組（faceGroupDelete）

package facesearch;

import com.jdcloud.apigateway.signature.JdcloudSDKClient;
import com.jdcloud.sdk.utils.BinaryUtils;
import com.google.api.client.http.HttpResponse;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
 
import static com.jdcloud.sdk.http.Protocol.HTTP;

//刪除分組
public class faceGroupDelete {
    public static void main(String[] args) {
        String accessKey = "請輸入您的AK";
        String secretKey = "請輸入您的SK";
        String endPoint = "aiapi.jdcloud.com";
        String path = "/jdai/faceGroupDelete";
        String method = "POST";
        Map<String, String> headers = new HashMap<>();
        Map<String, Object> queryMap = new HashMap<>();
        //queryMap.put("groupId", "10");
        queryMap.put("groupName", "請輸入分組名稱");
        String body = "{}";
        try {
            HttpResponse response = JdcloudSDKClient.execute(accessKey, secretKey, HTTP,
                endPoint, path, method, headers, queryMap, body);
            System.out.println(new String(BinaryUtils.toByteArray(response.getContent())));
        } catch (IOException e) {
           System.out.println(e.getMessage());
        }
    }
}

分組列表獲取（getFaceGroupList）

package facesearch;

import com.jdcloud.apigateway.signature.JdcloudSDKClient;
import com.jdcloud.sdk.utils.BinaryUtils;
import com.google.api.client.http.HttpResponse;
 import java.io.IOException;
import java.util.HashMap;
 import java.util.Map;

import static com.jdcloud.sdk.http.Protocol.HTTP;

//獲取分組列表
public class getFaceGroupList {
    public static void main(String[] args) {
        String accessKey = "請輸入您的AK";
       String secretKey = "請輸入您的SK";
        String endPoint = "aiapi.jdcloud.com";
        String path = "/jdai/getFaceGroupList";
        String method = "POST";
      Map<String, String> headers = new HashMap<>();
        Map<String, Object> queryMap = new HashMap<>();
        queryMap.put("start", "0");
        queryMap.put("length", "5");
        String body = "aaa";
        try {
            HttpResponse response = JdcloudSDKClient.execute(accessKey, secretKey, HTTP,
                endPoint, path, method, headers, queryMap, body);
            System.out.println(new String(BinaryUtils.toByteArray(response.getContent())));
        } catch (IOException e) {
            System.out.println(e.getMessage());
        }
    }
}

人臉創建（faceCreate）

package facesearch;

import com.jdcloud.apigateway.signature.JdcloudSDKClient;
import com.jdcloud.sdk.utils.BinaryUtils;
import com.google.api.client.http.HttpResponse;
 import java.io.IOException;
 import java.util.HashMap;
 import java.util.Map;
 
import static com.jdcloud.sdk.http.Protocol.HTTP;

//創建人臉
public class faceCreate {
    public static void main(String[] args) {
        String accessKey = "請輸入您的AK";
        String secretKey = "請輸入您的SK";
        String endPoint = "aiapi.jdcloud.com";
        String path = "/jdai/faceCreate";
        String method = "POST";
        //創建
        Map<String, String> dataMap = new HashMap<>();
        //在線圖片轉base64：http://imgbase64.duoshitong.com/
       dataMap.put("marin1", "imageBase64=圖片轉換為Base64后的代碼（去掉前面的data:image/jpeg;base64,）");
        dataMap.put("marin2", "imageBase64=圖片轉換為Base64后的代碼（去掉前面的data:image/jpeg;base64,）");
        dataMap.put("corona", "imageBase64=圖片轉換為Base64后的代碼（去掉前面的data:image/jpeg;base64,）");
        dataMap.put("dog", "imageBase64=圖片轉換為Base64后的代碼（去掉前面的data:image/jpeg;base64,）");
        Map<String, String> headers = new HashMap<>();
        Map<String, Object> queryMap = new HashMap<>();
        queryMap.put("groupName", "請輸入分組名稱");
        String body;
        for (Map.Entry<String, String> entry: dataMap.entrySet()){
            queryMap.put("outerId", entry.getKey());
            body = entry.getValue();
            try {
                HttpResponse response = JdcloudSDKClient.execute(accessKey, secretKey, HTTP,
                    endPoint, path, method, headers, queryMap, body);
                System.out.println(new String(BinaryUtils.toByteArray(response.getContent())));
            } catch (IOException e) {
                System.out.println(e.getMessage());
            }
            queryMap.remove("outerId");
        }
    }
}

人臉刪除（faceDelete）

package facesearch;

import com.jdcloud.apigateway.signature.JdcloudSDKClient;
import com.jdcloud.sdk.utils.BinaryUtils;
import com.google.api.client.http.HttpResponse;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

import static com.jdcloud.sdk.http.Protocol.HTTP;

//刪除人臉
public class faceDelete {
   public static void main(String[] args) {
        String accessKey = "請輸入您的AK";
        String secretKey = "請輸入您的SK";
        String endPoint = "aiapi.jdcloud.com";
        String path = "/jdai/faceDelete";
        String method = "POST";
       Map<String, String> headers = new HashMap<>();
        Map<String, Object> queryMap = new HashMap<>();
        queryMap.put("groupName", "請輸入分組名稱");
        queryMap.put("outerId", "marin1");
        queryMap.put("outerId", "marin2");
        queryMap.put("outerId", "corona");
       queryMap.put("outerId", "dog");
        String body = "{}";
        try {
           HttpResponse response = JdcloudSDKClient.execute(accessKey, secretKey, HTTP,
                endPoint, path, method, headers, queryMap, body);
            System.out.println(new String(BinaryUtils.toByteArray(response.getContent())));
        } catch (IOException e) {
            System.out.println(e.getMessage());
       }
    }
}

人臉搜索（faceSearch）

package facesearch;

import com.jdcloud.apigateway.signature.JdcloudSDKClient;
import com.jdcloud.sdk.utils.BinaryUtils;
import com.google.api.client.http.HttpResponse;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

import static com.jdcloud.sdk.http.Protocol.HTTP;

//人臉搜索
public class faceSearch {
    public static void main(String[] args) {
        String accessKey = "請輸入您的AK";
        String secretKey = "請輸入您的SK";
        String endPoint = "aiapi.jdcloud.com";
        String path = "/jdai/faceSearch";
        String method = "POST";
       Map<String, String> headers = new HashMap<>();
        Map<String, Object> queryMap = new HashMap<>();
        queryMap.put("groupName", "請輸入分組名稱");
        //如下填寫同一人的第三張人臉Base64代碼進行人臉搜索,這里用人臉marin.jpg
        String body = "imageBase64=圖片轉換為Base64后的代碼（去掉前面的data:image/jpeg;base64,）";
        try {
           HttpResponse response = JdcloudSDKClient.execute(accessKey, secretKey, HTTP,
                endPoint, path, method, headers, queryMap, body);
            System.out.println(new String(BinaryUtils.toByteArray(response.getContent())));
        } catch (IOException e) {
            System.out.println(e.getMessage());
        }
    }
}

4.進行演示

如下演示都通過右擊對應的代碼執行Run as-1 Java Application來運行代碼查看結果

創建分組

運行faceGroupCreate.java，結果如下：

獲取分組列表

運行getFaceGroupList.java，結果如下：

創建人臉庫

運行faceCreate.java，結果如下：

人臉搜索

運行faceSearch.java，結果如下：

刪除人臉

運行faceDelete.java，結果如下：

刪除分組

運行faceGroupDelete.java，結果如下：

如上，我們通過marin1.jpg、marin2.jpg、corona.jpg、dog.jpg創建了人臉庫，最后通過marin.jpg將相似度最高的marin1.jpg搜索了出來，至此，操作演示完畢~~

點擊“京東雲”了解京東雲人臉對比