com.baidu.aip
       ├── auth                                //签名相关类
       ├── http                                //Http通信相关类
       ├── client                              //公用类
       ├── exception                           //exception类
       ├── face
       │       └── AipFace           //AipFace类
       └── util                                //工具类

<dependency>
    <groupId>com.baidu.aip</groupId>
    <artifactId>java-sdk</artifactId>
    <version>${version}</version>
</dependency>

public class Sample {
    //设置APPID/AK/SK
    public static final String APP_ID = "你的 App ID";
    public static final String API_KEY = "你的 Api Key";
    public static final String SECRET_KEY = "你的 Secret Key";

    public static void main(String[] args) {
        // 初始化一个AipFace
        AipFace client = new AipFace(APP_ID, API_KEY, SECRET_KEY);

        // 可选：设置网络连接参数
        client.setConnectionTimeoutInMillis(2000);
        client.setSocketTimeoutInMillis(60000);

        // 可选：设置代理服务器地址, http和socket二选一，或者均不设置
        client.setHttpProxy("proxy_host", proxy_port);  // 设置http代理
        client.setSocketProxy("proxy_host", proxy_port);  // 设置socket代理

        // 调用接口
        String image = "取决于image_type参数，传入BASE64字符串或URL字符串或FACE_TOKEN字符串";
        String imageType = "BASE64";
    
        // 人脸检测
        JSONObject res = client.detect(image, imageType, options);
        System.out.println(res.toString(2));
        
    }
}

<dependency>
    <groupId>com.baidu.aip</groupId>
    <artifactId>java-sdk</artifactId>
    <version>${version}</version>
    <exclusions>
        <exclusion>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-simple</artifactId>
        </exclusion>
    </exclusions>
</dependency>

public void sample(AipFace client) {
    // 传入可选参数调用接口
    HashMap<String, Object> options = new HashMap<String, Object>();
    options.put("face_field", "age");
    options.put("max_face_num", "2");
    options.put("face_type", "LIVE");
    options.put("liveness_control", "LOW");
    
    String image = "取决于image_type参数，传入BASE64字符串或URL字符串或FACE_TOKEN字符串";
    String imageType = "BASE64";
    
    // 人脸检测
    JSONObject res = client.detect(image, imageType, options);
    System.out.println(res.toString(2));

}

{
  "face_num": 1,
  "face_list": [
        {
            "face_token": "35235asfas21421fakghktyfdgh68bio",
            "location": {
                "left": 117,
                "top": 131,
                "width": 172,
                "height": 170,
                "rotation": 4
            },
            "face_probability": 1,
            "angle" :{
                 "yaw" : -0.34859421849251
                 "pitch" 1.9135693311691
                 "roll" :2.3033397197723
            }
            "landmark": [
                {
                    "x": 161.74819946289,
                    "y": 163.30244445801
                },
                ...
            ],
            "landmark72": [
                {
                    "x": 115.86531066895,
                    "y": 170.0546875
                }，
                ...
            ],
            "age": 29.298097610474,
            "beauty": 55.128883361816,
            "expression": {
                "type": "smile",
                "probability" : 0.5543018579483
            },
            "gender": {
                "type": "male",
                "probability": 0.99979132413864
            },
            "glasses": {
          "type": "sun",
                "probability": 0.99999964237213
            },
            "face_shape": {
                "type": "triangle",
                "probability": 0.5543018579483
            }
            "quality": {
                "occlusion": {
                    "left_eye": 0,
                    "right_eye": 0,
                    "nose": 0,
                    "mouth": 0,
                    "left_cheek": 0.0064102564938366,
                    "right_cheek": 0.0057411273010075,
                    "chin": 0
                },
                "blur": 1.1886881756684e-10,
                "illumination": 141,
                "completeness": 1
            }
        }
    ]
}

public void sample(AipFace client) {
    // 传入可选参数调用接口
    HashMap<String, String> options = new HashMap<String, Object>();
    options.put("match_threshold", "70");
    options.put("quality_control", "NORMAL");
    options.put("liveness_control", "LOW");
    options.put("user_id", "233451");
    options.put("max_user_num", "3");
    
    String image = "取决于image_type参数，传入BASE64字符串或URL字符串或FACE_TOKEN字符串";
    String imageType = "BASE64";
    String groupIdList = "3,2";
    
    // 人脸搜索
    JSONObject res = client.search(image, imageType, groupIdList, options);
    System.out.println(res.toString(2));

}

{
  "face_token": "fid",
  "user_list": [
     {
        "group_id" : "test1",
        "user_id": "u333333",
        "user_info": "Test User",
        "score": 99.3
    }
  ]
}

public void sample(AipFace client) {
    // 传入可选参数调用接口
    HashMap<String, String> options = new HashMap<String, Object>();
    options.put("max_face_num", "3");
    options.put("match_threshold", "70");
    options.put("quality_control", "NORMAL");
    options.put("liveness_control", "LOW");
    options.put("max_user_num", "3");
    
    String image = "取决于image_type参数，传入BASE64字符串或URL字符串或FACE_TOKEN字符串";
    String imageType = "BASE64";
    String groupIdList = "3,2";
    
    // 人脸搜索 M:N 识别
    JSONObject res = client.multiSearch(image, imageType, groupIdList, options);
    System.out.println(res.toString(2));

}

{
    "error_code": 0,
    "error_msg": "SUCCESS",
    "log_id": 240483475,
    "timestamp": 1535533440,
    "cached": 0,
    "result": {
        "face_num": 2,
        "face_list": [
            {
                "face_token": "6fe19a6ee0c4233db9b5bba4dc2b9233",
                "location": {
                    "left": 31.95568085,
                    "top": 120.3764267,
                    "width": 87,
                    "height": 85,
                    "rotation": -5
                },
                "user_list": [
                    {
                        "group_id": "group1",
                        "user_id": "5abd24fd062e49bfa906b257ec40d284",
                        "user_info": "userinfo1",
                        "score": 69.85684967041
                    },
                    {
                        "group_id": "group1",
                        "user_id": "2abf89cffb31473a9948268fde9e1c3f",
                        "user_info": "userinfo2",
                        "score": 66.586112976074
                    }
                ]
            },
            {
                "face_token": "fde61e9c074f48cf2bbb319e42634f41",
                "location": {
                    "left": 219.4467773,
                    "top": 104.7486954,
                    "width": 81,
                    "height": 77,
                    "rotation": 3
                },
                "user_list": [
                    {
                        "group_id": "group1",
                        "user_id": "088717532b094c3990755e91250adf7d",
                        "user_info": "userinfo",
                        "score": 65.154159545898
                    }
                ]
            }
        ]
    }
}

|- 人脸库
   |- 用户组一
      |- 用户01
         |- 人脸
      |- 用户02
         |- 人脸
         |- 人脸
         ....
       ....
   |- 用户组二
   |- 用户组三
   |- 用户组四
   ....

public void sample(AipFace client) {
    // 传入可选参数调用接口
    HashMap<String, String> options = new HashMap<String, Object>();
    options.put("user_info", "user's info");
    options.put("quality_control", "NORMAL");
    options.put("liveness_control", "LOW");
    options.put("action_type", "REPLACE");
    
    String image = "取决于image_type参数，传入BASE64字符串或URL字符串或FACE_TOKEN字符串";
    String imageType = "BASE64";
    String groupId = "group1";
    String userId = "user1";
    
    // 人脸注册
    JSONObject res = client.addUser(image, imageType, groupId, userId, options);
    System.out.println(res.toString(2));

}

{
  "face_token": "2fa64a88a9d5118916f9a303782a97d3",
  "location": {
      "left": 117,
      "top": 131,
      "width": 172,
      "height": 170,
      "rotation": 4
  }
}

public void sample(AipFace client) {
    // 传入可选参数调用接口
    HashMap<String, String> options = new HashMap<String, Object>();
    options.put("user_info", "user's info");
    options.put("quality_control", "NORMAL");
    options.put("liveness_control", "LOW");
    options.put("action_type", "REPLACE");
    
    String image = "取决于image_type参数，传入BASE64字符串或URL字符串或FACE_TOKEN字符串";
    String imageType = "BASE64";
    String groupId = "group1";
    String userId = "user1";
    
    // 人脸更新
    JSONObject res = client.updateUser(image, imageType, groupId, userId, options);
    System.out.println(res.toString(2));

}

{
  "face_token": "2fa64a88a9d5118916f9a303782a97d3",
  "location": {
      "left": 117,
      "top": 131,
      "width": 172,
      "height": 170,
      "rotation": 4
  }
}

public void sample(AipFace client) {
    // 传入可选参数调用接口
    HashMap<String, String> options = new HashMap<String, Object>();
    
    String userId = "user1";
    String groupId = "group1";
    String faceToken = "face_token_23123";
    
    // 人脸删除
    JSONObject res = client.faceDelete(userId, groupId, faceToken, options);
    System.out.println(res.toString(2));

}

// 删除成功
{
  "error_code": 0,
  "log_id": 73473737,
}
// 删除发生错误
{
  "error_code": 223106,
  "log_id": 1382953199,
  "error_msg": "face is not exist"
}

public void sample(AipFace client) {
    // 传入可选参数调用接口
    HashMap<String, String> options = new HashMap<String, Object>();
    
    String userId = "user1";
    String groupId = "group1";
    
    // 用户信息查询
    JSONObject res = client.getUser(userId, groupId, options);
    System.out.println(res.toString(2));

}

{
  "user_list": [
      {
          "user_info": "user info ...",
          "group_id": "gid1"
      },
      {
          "user_info": "user info2 ...",
          "group_id": "gid2"
      }
  ]
}

public void sample(AipFace client) {
    // 传入可选参数调用接口
    HashMap<String, String> options = new HashMap<String, Object>();
    
    String userId = "user1";
    String groupId = "group1";
    
    // 获取用户人脸列表
    JSONObject res = client.faceGetlist(userId, groupId, options);
    System.out.println(res.toString(2));

}

{
  "face_list": [
      {
          "face_token": "fid1",
          "ctime": "2018-01-01 00:00:00"
      },
      {
          "face_token": "fid2",
          "ctime": "2018-01-01 10:00:00"
      }
  ]
}

public void sample(AipFace client) {
    // 传入可选参数调用接口
    HashMap<String, String> options = new HashMap<String, Object>();
    options.put("start", "0");
    options.put("length", "50");
    
    String groupId = "group1";
    
    // 获取用户列表
    JSONObject res = client.getGroupUsers(groupId, options);
    System.out.println(res.toString(2));

}

{
  "user_id_list": [
      "uid1",
      "uid2"
  ]
}

public void sample(AipFace client) {
    // 传入可选参数调用接口
    HashMap<String, String> options = new HashMap<String, Object>();
    options.put("src_group_id", "11111");
    options.put("dst_group_id", "222222");
    
    String userId = "user1";
    
    // 复制用户
    JSONObject res = client.userCopy(userId, options);
    System.out.println(res.toString(2));

}

// 正确返回值
{
   "error_code": 0,
  "log_id": 3314921889,
}
// 发生错误时返回值
{
  "error_code": 216100,
  "log_id": 3111284097,
  "error_msg": "already add"
}

public void sample(AipFace client) {
    // 传入可选参数调用接口
    HashMap<String, String> options = new HashMap<String, Object>();
    
    String groupId = "group1";
    String userId = "user1";
    
    // 删除用户
    JSONObject res = client.deleteUser(groupId, userId, options);
    System.out.println(res.toString(2));

}

// 正确返回值
{

  "error_code": 0,
  "log_id": 3314921889,
}
// 发生错误时返回值
{
  "error_code":  223103,
  "log_id": 815967402,
  "error_msg": "user is not exist"
}

public void sample(AipFace client) {
    // 传入可选参数调用接口
    HashMap<String, String> options = new HashMap<String, Object>();
    
    String groupId = "group1";
    
    // 创建用户组
    JSONObject res = client.groupAdd(groupId, options);
    System.out.println(res.toString(2));

}

{

  "error_code": 0,
  "log_id": 3314921889,
}
// 发生错误时返回值
{
  "error_code":  223101,
  "log_id": 815967402,
  "error_msg": " group is already exist"
}

public void sample(AipFace client) {
    // 传入可选参数调用接口
    HashMap<String, String> options = new HashMap<String, Object>();
    
    String groupId = "group1";
    
    // 删除用户组
    JSONObject res = client.groupDelete(groupId, options);
    System.out.println(res.toString(2));

}

// 正确返回值
{

  "error_code":0,
  "log_id": 3314921889,
}
// 发生错误时返回值
{
  "error_code": 223100,
  "log_id": 815967402,
  "error_msg": " group is not exist"
}

public void sample(AipFace client) {
    // 传入可选参数调用接口
    HashMap<String, String> options = new HashMap<String, Object>();
    options.put("start", "0");
    options.put("length", "50");
    
    
    // 组列表查询
    JSONObject res = client.getGroupList(options);
    System.out.println(res.toString(2));

}

{
    "group_id_list": [
        "gid1",
        "gid2"
    ]
}

public void sample(AipFace client) {
    // 传入可选参数调用接口
    HashMap<String, String> options = new HashMap<String, Object>();
    options.put("quality_control", "NORMAL");
    options.put("liveness_control", "LOW");
    
    String image = "取决于image_type参数，传入BASE64字符串或URL字符串或FACE_TOKEN字符串";
    String imageType = "BASE64";
    String idCardNumber = "110233112299822211";
    String name = "张三";
    
    // 身份验证
    JSONObject res = client.personVerify(image, imageType, idCardNumber, name, options);
    System.out.println(res.toString(2));

}

{
  "score": 44.3,
}

public void sample(AipFace client) {
    // 传入可选参数调用接口
    HashMap<String, String> options = new HashMap<String, Object>();
    options.put("appid", "223245");
    
    
    // 语音校验码接口
    JSONObject res = client.videoSessioncode(, options);
    System.out.println(res.toString(2));

}

{
  "err_no": 0,
  "err_msg": "SUCCESS",
  "result": {
    "session_id": "S59faeeebb9111890355690",
    "code": "9940"
  },
  "timestamp": 1509617387,
  "cached": 0,
  "serverlogid": "0587756642"
}

public void sample(AipFace client) {
    // 传入可选参数调用接口
    HashMap<String, String> options = new HashMap<String, Object>();

    String sessionId = "110233112299822211";

    // 参数为本地路径
    String video = "video.mp4";
    JSONObject res = client.videoFaceliveness(sessionId, video, options);
    System.out.println(res.toString(2));

    // 参数为二进制数组
    byte[] file = readFile("video.mp4");
    res = client.videoFaceliveness(file, sessionId, options);
    System.out.println(res.toString(2));
}

{
  err_no:0,
  err_msg: 'success',
  result: {
    score: 0.984654366,
    thresholds: {
      "frr_1e-4": 0.05, //万分之一误识别率的阈值
      "frr_1e-3": 0.3,  //千分之一误识别率的阈值
      "frr_1e-2": 0.9   //百分之一误识别率的阈值
      },
      code: {
        "create": "5789",
        "identify": "5789"
      },
      pic_list: [
        {
          "face_id": 5745745747,
          "pic": "gsagaheryzxv..."
        },
        {
          "face_id": 5745745747,
          "pic": "gsagaheryzxv..."
        }
      ]
  },
  "timestamp": 1509611848,
  "cached": 0,
  "serverlogid": "2248375729"
}

public void sample(AipFace client) {
    String image1 = "base64_1";
    String image2 = "base64_2";

    // image1/image2也可以为url或facetoken, 相应的imageType参数需要与之对应。
    MatchRequest req1 = new MatchRequest(image1, "BASE64");
    MatchRequest req2 = new MatchRequest(image2, "BASE64");
    ArrayList<MatchRequest> requests = new ArrayList<MatchRequest>();
    requests.add(req1);
    requests.add(req2);

    JSONObject res = client.match(requests);
    System.out.println(res.toString(2));

}

{
  "score": 44.3,
  "face_list": [  //返回的顺序与传入的顺序保持一致
      {
          "face_token": "fid1"
      },
      {
          "face_token": "fid2"
      }
  ]
}

public void sample(AipFace client) {
    String image = "image_base64_content";
    FaceVerifyRequest req = new FaceVerifyRequest(image, "BASE64");
    ArrayList<FaceVerifyRequest> list = new ArrayList<FaceVerifyRequest>();
    list.add(req);
    JSONObject res = client.faceverify(list);
    System.out.println(res.toString(2));
}

{
    "thresholds": {
        "frr_1e-4": 0.05,
        "frr_1e-3": 0.3,
        "frr_1e-2": 0.9
    },
    "face_liveness": 0.05532243927,
    "face_list": [
        {
            "face_token": "df46f7c7db4aa09a093c26fb8d1a8d44",
            "location": {
                "left": 328.9026489,
                "top": 97.16340637,
                "width": 162,
                "height": 154,
                "rotation": 32
            },
            "face_probability": 1,
            "angle": {
                "yaw": 10.16196251,
                "pitch": 2.244354248,
                "roll": 33.82199097
            },
            "liveness": {
                "faceliveness": 0.004187555984,
                "livemapscore": 0.04492170034
            },
            "age": 23,
            "beauty": 20.23693275
        },
        {
            "face_token": "901d2c64274fccd687d311a6e6110a01",
            "location": {
                "left": 411.4876404,
                "top": 166.3593445,
                "width": 329,
                "height": 308,
                "rotation": 45
            },
            "face_probability": 0.9194830656,
            "angle": {
                "yaw": -1.716423035,
                "pitch": 7.344647408,
                "roll": 45.79914856
            },
            "liveness": {
                "faceliveness": 0.0001665892196,
                "livemapscore": 0.001787073661
            },
            "age": 23,
            "beauty": 12.6438179
        },
        {
            "face_token": "7d57e36981c48b4946eb97c8d838b02a",
            "location": {
                "left": 161.4559937,
                "top": 199.8726501,
                "width": 218,
                "height": 201,
                "rotation": -1
            },
            "face_probability": 1,
            "angle": {
                "yaw": -8.187754631,
                "pitch": 6.973727226,
                "roll": -1.25429821
            },
            "liveness": {
                "faceliveness": 0.02942637168,
                "livemapscore": 0.05532243927
            },
            "age": 23,
            "beauty": 8.20657444
        }
    ]
}

public void sample(AipFace client) {
  
    // 必填参数
    String idCardNumber = "";
    String name = "";
    String image = "";
  
    // 选填参数
    HashMap<String, Object> options = new HashMap<String, Object>();
    options.put("xxx", "xxx");

    // 调用接口
    JSONObject res = client.faceMingJingVerify(idCardNumber, name, image, options);
    System.out.println(res.toString(2));
}

{
    "log_id": 1370579072568000512,
    "result": {
        "score": 40.884,
        "verify_status": 0
    },
    "dec_image": "/9j/4AAQSkZJRgABAgAAAQABAAD",
    "risk_level": "3",
    "risk_tag": [
        "若判断为有风险，则会有风险标签json 数组告知风险类型，如：general_inject"
    ]
}

public void sample(AipFace client) {
  
    // 必填参数
  	String image = "";
    String imageType = "";
    String registerImage = "";
    String registerImageType = "";
  
    // 选填参数
    HashMap<String, Object> options = new HashMap<String, Object>();
    options.put("xxx", "xxx");

    // 调用接口
    JSONObject res = client.faceMingJingMatch(image, imageType, registerImage, registerImageType, null);
    System.out.println(res.toString(2));
}

  {
    "log_id": 1370585066551377920,
    "result": {
        "score": 99.06919861,
        "face_list": [
            {
                "face_token": "549f9f1d1c7ec8c86931540b1939e8ed"
            },
            {
                "face_token": "1a319460ef89e8d27fb59062a28dbad7"
            }
        ]
    },
    "dec_image": "/9j/4AAQSkZJRgABAQAAAQABAAD",
    "risk_level": "3",
    "risk_tag": [
        "空"
    ]
}
 

public void sample(AipFace client) {
  
  	// 必填参数
    String sdkVersion = "";
  
    // 选填参数
    HashMap<String, Object> options = new HashMap<String, Object>();
    options.put("xxx", "xxx");

   	// 调用接口
    JSONObject res = client.onlinePictureLiveV4(sdkVersion, options);
    System.out.println(res.toString(2));
}

{
    "result": {
        "thresholds": {
            "frr_1e-3": 0.3,
            "frr_1e-2": 0.9,
            "frr_1e-4": 0.05
        },
        "face_liveness": 0.1976952702,
        "face_list": [
            {
                "liveness": {
                    "livemapscore": 0.1976952702
                },
                "angle": {
                    "roll": 0.31,
                    "pitch": -2.07,
                    "yaw": 0.85
                },
                "face_token": "abd1b4ce743099336cfed40193ff4944",
                "location": {
                    "top": 161.74,
                    "left": 79.04,
                    "rotation": 1,
                    "width": 318,
                    "height": 333
                },
                "face_probability": 1
            },
            {
                "liveness": {
                    "livemapscore": 0.1976952702
                },
                "angle": {
                    "roll": 0.31,
                    "pitch": -2.07,
                    "yaw": 0.85
                },
                "face_token": "abd1b4ce743099336cfed40193ff4944",
                "location": {
                    "top": 161.74,
                    "left": 79.04,
                    "rotation": 1,
                    "width": 318,
                    "height": 333
                },
                "face_probability": 1
            },
            {
                "liveness": {
                    "livemapscore": 0.1976952702
                },
                "angle": {
                    "roll": 0.31,
                    "pitch": -2.07,
                    "yaw": 0.85
                },
                "face_token": "abd1b4ce743099336cfed40193ff4944",
                "location": {
                    "top": 161.74,
                    "left": 79.04,
                    "rotation": 1,
                    "width": 318,
                    "height": 333
                },
                "face_probability": 1
            },
            {
                "liveness": {
                    "livemapscore": 0.1976952702
                },
                "angle": {
                    "roll": 0.31,
                    "pitch": -2.07,
                    "yaw": 0.85
                },
                "face_token": "abd1b4ce743099336cfed40193ff4944",
                "location": {
                    "top": 161.74,
                    "left": 79.04,
                    "rotation": 1,
                    "width": 318,
                    "height": 333
                },
                "face_probability": 1
            },
            {
                "liveness": {
                    "livemapscore": 0.1976952702
                },
                "angle": {
                    "roll": 0.31,
                    "pitch": -2.07,
                    "yaw": 0.85
                },
                "face_token": "abd1b4ce743099336cfed40193ff4944",
                "location": {
                    "top": 161.74,
                    "left": 79.04,
                    "rotation": 1,
                    "width": 318,
                    "height": 333
                },
                "face_probability": 1
            },
            {
                "liveness": {
                    "livemapscore": 0.1976952702
                },
                "angle": {
                    "roll": 0.31,
                    "pitch": -2.07,
                    "yaw": 0.85
                },
                "face_token": "abd1b4ce743099336cfed40193ff4944",
                "location": {
                    "top": 161.74,
                    "left": 79.04,
                    "rotation": 1,
                    "width": 318,
                    "height": 333
                },
                "face_probability": 1
            },
            {
                "liveness": {
                    "livemapscore": 0.1976952702
                },
                "angle": {
                    "roll": 0.31,
                    "pitch": -2.07,
                    "yaw": 0.85
                },
                "face_token": "abd1b4ce743099336cfed40193ff4944",
                "location": {
                    "top": 161.74,
                    "left": 79.04,
                    "rotation": 1,
                    "width": 318,
                    "height": 333
                },
                "face_probability": 1
            },
            {
                "liveness": {
                    "livemapscore": 0.1976952702
                },
                "angle": {
                    "roll": 0.31,
                    "pitch": -2.07,
                    "yaw": 0.85
                },
                "face_token": "abd1b4ce743099336cfed40193ff4944",
                "location": {
                    "top": 161.74,
                    "left": 79.04,
                    "rotation": 1,
                    "width": 318,
                    "height": 333
                },
                "face_probability": 1
            }
        ]
    },
    "risk_level": "3",
    "log_id": 1423545654699779516,
    "risk_tag": [
        "空"
    ],
    "dec_image": [
            "/9j/4AAQ..."
    ]
}