1├── README.md
2├── aip                   //SDK目录
3│   ├── __init__.py       //导出类
4│   ├── base.py           //aip基类
5│   ├── http.py           //http请求
6│   └── face.py //人脸识别
7└── setup.py              //setuptools安装

1from aip import AipFace
2
3""" 你的 APPID AK SK """
4APP_ID = '你的 App ID'
5API_KEY = '你的 Api Key'
6SECRET_KEY = '你的 Secret Key'
7
8client = AipFace(APP_ID, API_KEY, SECRET_KEY)

1""" 读取图片 """
2def get_file_content(filePath):
3    with open(filePath, 'rb') as fp:
4        return fp.read()
5
6image = get_file_content('example.jpg')
7
8""" 调用人脸检测 """
9client.detect(image);
10
11""" 如果有可选参数 """
12options = {}
13options["max_face_num"] = 2
14options["face_fields"] = "age"
15
16""" 带参数调用人脸检测 """
17client.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""" 读取图片 """
2def get_file_content(filePath):
3    with open(filePath, 'rb') as fp:
4        return fp.read()
5
6images = [
7    get_file_content('example0.jpg'),
8    get_file_content('example1.jpg'),
9]
10
11""" 调用人脸比对 """
12client.match(images);
13
14""" 如果有可选参数 """
15options = {}
16options["ext_fields"] = "qualities"
17options["image_liveness"] = ",faceliveness"
18options["types"] = "7,13"
19
20""" 带参数调用人脸比对 """
21client.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}

1groupId = "group1,group2"
2
3""" 读取图片 """
4def get_file_content(filePath):
5    with open(filePath, 'rb') as fp:
6        return fp.read()
7
8image = get_file_content('example.jpg')
9
10""" 调用人脸识别 """
11client.identifyUser(groupId, image);
12
13""" 如果有可选参数 """
14options = {}
15options["ext_fields"] = "faceliveness"
16options["user_top_num"] = 3
17
18""" 带参数调用人脸识别 """
19client.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}

1uid = "user1"
2
3groupId = "group1,group2"
4
5""" 读取图片 """
6def get_file_content(filePath):
7    with open(filePath, 'rb') as fp:
8        return fp.read()
9
10image = get_file_content('example.jpg')
11
12""" 调用人脸认证 """
13client.verifyUser(uid, groupId, image);
14
15""" 如果有可选参数 """
16options = {}
17options["top_num"] = 3
18options["ext_fields"] = "faceliveness"
19
20""" 带参数调用人脸认证 """
21client.verifyUser(uid, groupId, image, options)

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

1groupId = "group1,group2"
2
3""" 读取图片 """
4def get_file_content(filePath):
5    with open(filePath, 'rb') as fp:
6        return fp.read()
7
8image = get_file_content('example.jpg')
9
10""" 调用M:N 识别 """
11client.multiIdentify(groupId, image);
12
13""" 如果有可选参数 """
14options = {}
15options["ext_fields"] = "faceliveness"
16options["detect_top_num"] = 3
17options["user_top_num"] = 2
18
19""" 带参数调用M:N 识别 """
20client.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   ....

1uid = "user1"
2
3userInfo = "user's info"
4
5groupId = "group1,group2"
6
7""" 读取图片 """
8def get_file_content(filePath):
9    with open(filePath, 'rb') as fp:
10        return fp.read()
11
12image = get_file_content('example.jpg')
13
14""" 调用人脸注册 """
15client.addUser(uid, userInfo, groupId, image);
16
17""" 如果有可选参数 """
18options = {}
19options["action_type"] = "replace"
20
21""" 带参数调用人脸注册 """
22client.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}

1uid = "user1"
2
3userInfo = "user's info"
4
5groupId = "group1"
6
7""" 读取图片 """
8def get_file_content(filePath):
9    with open(filePath, 'rb') as fp:
10        return fp.read()
11
12image = get_file_content('example.jpg')
13
14""" 调用人脸更新 """
15client.updateUser(uid, userInfo, groupId, image);
16
17""" 如果有可选参数 """
18options = {}
19options["action_type"] = "replace"
20
21""" 带参数调用人脸更新 """
22client.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}

1uid = "user1"
2
3""" 调用人脸删除 """
4client.deleteUser(uid);
5
6""" 如果有可选参数 """
7options = {}
8options["group_id"] = "group1"
9
10""" 带参数调用人脸删除 """
11client.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}

1uid = "user1"
2
3""" 调用用户信息查询 """
4client.getUser(uid);
5
6""" 如果有可选参数 """
7options = {}
8options["group_id"] = "group1"
9
10""" 带参数调用用户信息查询 """
11client.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""" 调用组列表查询 """
2client.getGroupList();
3
4""" 如果有可选参数 """
5options = {}
6options["start"] = 0
7options["num"] = 50
8
9""" 带参数调用组列表查询 """
10client.getGroupList(, options)

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

1groupId = "group1"
2
3""" 调用组内用户列表查询 """
4client.getGroupUsers(groupId);
5
6""" 如果有可选参数 """
7options = {}
8options["start"] = 0
9options["num"] = 50
10
11""" 带参数调用组内用户列表查询 """
12client.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}

1srcGroupId = "group1"
2
3groupId = "group1,group2"
4
5uid = "user1"
6
7""" 调用组间复制用户 """
8client.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}

1groupId = "group1,group2"
2
3uid = "user1"
4
5""" 调用组内删除用户 """
6client.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""" 读取图片 """
2def get_file_content(filePath):
3    with open(filePath, 'rb') as fp:
4        return fp.read()
5
6image = get_file_content('example.jpg')
7idCardNumber = "110233112299822211"
8
9name = "张三"
10
11""" 调用身份验证 """
12client.personVerify(image, idCardNumber, name);
13
14""" 如果有可选参数 """
15options = {}
16options["quality"] = "use"
17options["quality_conf"] = "{\"left_eye\": 0.6, \"right_eye\": 0.6}"
18options["faceliveness"] = "use"
19options["faceliveness_conf"] = "{\"faceliveness\": 0.834963}"
20options["ext_fields"] = "qualities"
21
22""" 带参数调用身份验证 """
23client.personVerify(image, idCardNumber, name, options)

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

1""" 读取图片 """
2def get_file_content(filePath):
3    with open(filePath, 'rb') as fp:
4        return fp.read()
5
6image = get_file_content('example.jpg')
7
8""" 调用在线活体检测 """
9client.faceverify(image);
10
11""" 如果有可选参数 """
12options = {}
13options["max_face_num"] = 2
14options["face_fields"] = "qualities"
15
16""" 带参数调用在线活体检测 """
17client.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}