1├── AipFace.php             //人脸识别
2└── lib
3    ├── AipHttpClient.php        //内部http请求类
4    ├── AipBCEUtil.php           //内部工具类
5    └── AipBase                  //Aip基类

1require_once 'AipFace.php';
2
3// 你的 APPID AK SK
4const APP_ID = '你的 App ID';
5const API_KEY = '你的 Api Key';
6const SECRET_KEY = '你的 Secret Key';
7
8$client = new AipFace(APP_ID, API_KEY, SECRET_KEY);

1$image = file_get_contents('example.jpg');
2
3// 调用人脸检测
4$client->detect($image);
5
6// 如果有可选参数
7$options = array();
8$options["max_face_num"] = 2;
9$options["face_fields"] = "age";
10
11// 带参数调用人脸检测
12$client->detect($image, $options);

1{
2    "result_num": 1,
3    "result": [
4        {
5            "location": {
6                "left": 117,
7                "top": 131,
8                "width": 172,
9                "height": 170
10            },
11            "face_probability": 1,
12            "rotation_angle": 2,
13            "yaw": -0.34859421849251,
14            "pitch": 2.3033397197723,
15            "roll": 1.9135693311691,
16            "landmark": [
17                {
18                    "x": 161.74819946289,
19                    "y": 163.30244445801
20                },
21                ...
22            ],
23            "landmark72": [
24                {
25                    "x": 115.86531066895,
26                    "y": 170.0546875
27                }，
28                ...
29            ],
30            "age": 29.298097610474,
31            "beauty": 55.128883361816,
32            "expression": 1,
33            "expression_probablity": 0.5543018579483,
34            "gender": "male",
35            "gender_probability": 0.99979132413864,
36            "glasses": 0,
37            "glasses_probability": 0.99999964237213,
38            "qualities": {
39                "occlusion": {
40                    "left_eye": 0,
41                    "right_eye": 0,
42                    "nose": 0,
43                    "mouth": 0,
44                    "left_cheek": 0.0064102564938366,
45                    "right_cheek": 0.0057411273010075,
46                    "chin": 0
47                },
48                "blur": 1.1886881756684e-10,
49                "illumination": 141,
50                "completeness": 1,
51                "type": {
52                    "human": 0.99935841560364,
53                    "cartoon": 0.00064159056637436
54                }
55            }
56        }
57    ],
58    "log_id": 2493878179101621
59}

1$images = array(
2    file_get_contents('example0.jpg'),
3    file_get_contents('example1.jpg'),
4);
5
6// 调用人脸比对
7$client->match($images);
8
9// 如果有可选参数
10$options = array();
11$options["ext_fields"] = "qualities";
12$options["image_liveness"] = ",faceliveness";
13$options["types"] = "7,13";
14
15// 带参数调用人脸比对
16$client->match($images, $options);

1//请求两张图片
2{
3    "log_id": 73473737,
4    "result_num":1,
5    "result": [
6        {
7            "index_i": 0,
8            "index_j": 1,
9            "score": 44.3
10        }
11    ]
12}

1$groupId = "group1,group2";
2
3$image = file_get_contents('example.jpg');
4
5// 调用人脸识别
6$client->identifyUser($groupId, $image);
7
8// 如果有可选参数
9$options = array();
10$options["ext_fields"] = "faceliveness";
11$options["user_top_num"] = 3;
12
13// 带参数调用人脸识别
14$client->identifyUser($groupId, $image, $options);

1{
2    "log_id": 73473737,
3    "result_num":1,
4    "result": [
5        {
6            "group_id" : "test1",
7            "uid": "u333333",
8            "user_info": "Test User",
9            "scores": [
10                    99.3,
11                    83.4
12            ]
13        }
14    ]
15}

1$uid = "user1";
2
3$groupId = "group1,group2";
4
5$image = file_get_contents('example.jpg');
6
7// 调用人脸认证
8$client->verifyUser($uid, $groupId, $image);
9
10// 如果有可选参数
11$options = array();
12$options["top_num"] = 3;
13$options["ext_fields"] = "faceliveness";
14
15// 带参数调用人脸认证
16$client->verifyUser($uid, $groupId, $image, $options);

1{
2    "log_id": 73473737,
3    "result_num":2,
4    "result": [
5            99.3,
6            83.6
7    ]
8}

1$groupId = "group1,group2";
2
3$image = file_get_contents('example.jpg');
4
5// 调用M:N 识别
6$client->multiIdentify($groupId, $image);
7
8// 如果有可选参数
9$options = array();
10$options["ext_fields"] = "faceliveness";
11$options["detect_top_num"] = 3;
12$options["user_top_num"] = 2;
13
14// 带参数调用M:N 识别
15$client->multiIdentify($groupId, $image, $options);

1{
2    "log_id": 73473737,
3    "result_num":1,
4    "result": [
5        {
6            "group_id" : "test1",
7            "uid": "u333333",
8            "user_info": "Test User",
9            "position":{"left":726.99188232422,"top":288.37701416016,"width":44,"height":42,"degree":-4,"prob":0.91117089986801},
10            "scores": [
11                    99.3
12            ]
13        },
14        {
15            "group_id" : "test1",
16            "uid": "u2222222",
17            "user_info": "Test User",
18            "position":{"left":726.99188232422,"top":288.37701416016,"width":44,"height":42,"degree":-4,"prob":0.91117089986801},
19            "scores": [
20                    82.3
21            ]
22        }
23    ]
24}

1|- 人脸库
2   |- 用户组一
3      |- 用户01
4         |- 人脸
5      |- 用户02
6         |- 人脸
7         |- 人脸
8         ....
9       ....
10   |- 用户组二
11   |- 用户组三
12   |- 用户组四
13   ....

1$uid = "user1";
2
3$userInfo = "user's info";
4
5$groupId = "group1,group2";
6
7$image = file_get_contents('example.jpg');
8
9// 调用人脸注册
10$client->addUser($uid, $userInfo, $groupId, $image);
11
12// 如果有可选参数
13$options = array();
14$options["action_type"] = "replace";
15
16// 带参数调用人脸注册
17$client->addUser($uid, $userInfo, $groupId, $image, $options);

1// 注册成功
2{
3    "log_id": 73473737,
4}
5// 注册发生错误
6{
7  "error_code": 216616,
8  "log_id": 674786177,
9  "error_msg": "image exist"
10}

1$uid = "user1";
2
3$userInfo = "user's info";
4
5$groupId = "group1";
6
7$image = file_get_contents('example.jpg');
8
9// 调用人脸更新
10$client->updateUser($uid, $userInfo, $groupId, $image);
11
12// 如果有可选参数
13$options = array();
14$options["action_type"] = "replace";
15
16// 带参数调用人脸更新
17$client->updateUser($uid, $userInfo, $groupId, $image, $options);

1// 更新成功
2{
3    "log_id": 73473737,
4}
5// 更新发生错误
6{
7  "error_code": 216612,
8  "log_id": 1137508902,
9  "error_msg": "user not exist"
10}

1$uid = "user1";
2
3// 调用人脸删除
4$client->deleteUser($uid);
5
6// 如果有可选参数
7$options = array();
8$options["group_id"] = "group1";
9
10// 带参数调用人脸删除
11$client->deleteUser($uid, $options);

1// 删除成功
2{
3    "log_id": 73473737,
4}
5// 删除发生错误
6{
7  "error_code": 216612,
8  "log_id": 1137508902,
9  "error_msg": "user not exist"
10}

1$uid = "user1";
2
3// 调用用户信息查询
4$client->getUser($uid);
5
6// 如果有可选参数
7$options = array();
8$options["group_id"] = "group1";
9
10// 带参数调用用户信息查询
11$client->getUser($uid, $options);

1{
2“result_num” : 2
3    "result": {
4        [
5            "uid": "testuser2",
6            "user_info": "registed user info ...",
7            "group_id": "grep1",
8        ],
9        [
10            "uid": "testuser2",
11            "user_info": "registed user info2 ...",
12            "group_id": "grep2",
13        ],
14    },
15    "log_id": 2979357502
16}

1// 调用组列表查询
2$client->getGroupList();
3
4// 如果有可选参数
5$options = array();
6$options["start"] = 0;
7$options["num"] = 50;
8
9// 带参数调用组列表查询
10$client->getGroupList(, $options);

1{
2    "result_num": 2,
3    "result": [
4        "grp1",
5        "grp2"
6    ],
7    "log_id": 3314921889
8}

1$groupId = "group1";
2
3// 调用组内用户列表查询
4$client->getGroupUsers($groupId);
5
6// 如果有可选参数
7$options = array();
8$options["start"] = 0;
9$options["num"] = 50;
10
11// 带参数调用组内用户列表查询
12$client->getGroupUsers($groupId, $options);

1{
2    "log_id": 3314921889,
3    "result_num": 2,
4    "result": [
5        {
6            "uid": "uid1",
7            "user_info": "user info 1"
8        },
9        {
10            "uid": "uid2",
11            "user_info": "user info 2"
12        }
13    ]
14}

1$srcGroupId = "group1";
2
3$groupId = "group1,group2";
4
5$uid = "user1";
6
7// 调用组间复制用户
8$client->addGroupUser($srcGroupId, $groupId, $uid);

1// 正确返回值
2{
3    "log_id": 3314921889,
4}
5// 发生错误时返回值
6{
7  "error_code": 216100,
8  "log_id": 3111284097,
9  "error_msg": "already add"
10}

1$groupId = "group1,group2";
2
3$uid = "user1";
4
5// 调用组内删除用户
6$client->deleteGroupUser($groupId, $uid);

1// 正确返回值
2{
3    "log_id": 3314921889,
4}
5// 发生错误时返回值
6{
7  "error_code": 216619,
8  "log_id": 815967402,
9  "error_msg": "user must be in one group at least"
10}

1$image = file_get_contents('example.jpg');
2$idCardNumber = "110233112299822211";
3
4$name = "张三";
5
6// 调用身份验证
7$client->personVerify($image, $idCardNumber, $name);
8
9// 如果有可选参数
10$options = array();
11$options["quality"] = "use";
12$options["quality_conf"] = "{\"left_eye\": 0.6, \"right_eye\": 0.6}";
13$options["faceliveness"] = "use";
14$options["faceliveness_conf"] = "{\"faceliveness\": 0.834963}";
15$options["ext_fields"] = "qualities";
16
17// 带参数调用身份验证
18$client->personVerify($image, $idCardNumber, $name, $options);

1{
2  "result":0.03419,
3  "ext_info":{
4    "faceliveness":0.834963
5  },
6  "log_id":772889134072410
7}

1$image = file_get_contents('example.jpg');
2
3// 调用在线活体检测
4$client->faceverify($image);
5
6// 如果有可选参数
7$options = array();
8$options["max_face_num"] = 2;
9$options["face_fields"] = "qualities";
10
11// 带参数调用在线活体检测
12$client->faceverify($image, $options);

1{
2    log_id: 1900901488032821,
3    result_num: 1,
4    result: [
5        {
6            rotation_angle: 10,
7            yaw: 11.357421875,
8            faceliveness: 8.1253347161692e-05,
9            location: {
10                width: 96,
11                top: 73,
12                height: 96,
13                left: 283
14            },
15            qualities: {
16                illumination: 211,
17                occlusion: {
18                    right_eye: 0,
19                    left_eye: 0.039751552045345,
20                    left_cheek: 0.12623985111713,
21                    mouth: 0,
22                    nose: 0,
23                    chin: 0.037661049515009,
24                    right_cheek: 0.024720622226596
25                },
26                completeness: 1,
27                type: {
28                    cartoon: 0,
29                    human: 0
30                },
31                blur: 2.5251445032182e-11
32            },
33            pitch: 1.0063140392303,
34            roll: 12.760620117188,
35            face_probability: 1
36        }
37    ]
38}