Baidu.Aip
    ├── net35
    │   ├── AipSdk.dll             // 百度AI服务 windows 动态库
    │   ├── AipSdk.xml             // 注释文件
    │   └── Newtonsoft.Json.dll    // 第三方依赖
    ├── net40
    ├── net45
    └── netstandard2.0
        ├── AipSdk.deps.json
        └── AipSdk.dll

// 设置APPID/AK/SK
var APP_ID = "你的 App ID";
var API_KEY = "你的 Api Key";
var SECRET_KEY = "你的 Secret Key";

var client = new Baidu.Aip.Face.Face(API_KEY, SECRET_KEY);
client.Timeout = 60000;  // 修改超时时间

public void DetectDemo() {
	var image = File.ReadAllBytes("图片文件路径");
	// 调用人脸检测，可能会抛出网络等异常，请使用try/catch捕获
	var result = client.Detect(image);
	Console.WriteLine(result);
	// 如果有可选参数
	var options = new Dictionary<string, object>{
	    {"max_face_num", 2},
	    {"face_fields", "age"}
	};
	// 带参数调用人脸检测
	result = client.Detect(image, options);
	Console.WriteLine(result);
}

{
    "result_num": 1,
    "result": [
        {
            "location": {
                "left": 117,
                "top": 131,
                "width": 172,
                "height": 170
            },
            "face_probability": 1,
            "rotation_angle": 2,
            "yaw": -0.34859421849251,
            "pitch": 2.3033397197723,
            "roll": 1.9135693311691,
            "landmark": [
                {
                    "x": 161.74819946289,
                    "y": 163.30244445801
                },
                ...
            ],
            "landmark72": [
                {
                    "x": 115.86531066895,
                    "y": 170.0546875
                }，
                ...
            ],
            "age": 29.298097610474,
            "beauty": 55.128883361816,
            "expression": 1,
            "expression_probablity": 0.5543018579483,
            "gender": "male",
            "gender_probability": 0.99979132413864,
            "glasses": 0,
            "glasses_probability": 0.99999964237213,
            "qualities": {
                "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,
                "type": {
                    "human": 0.99935841560364,
                    "cartoon": 0.00064159056637436
                }
            }
        }
    ],
    "log_id": 2493878179101621
}

public void MatchDemo() {
	var images = new[]
    {
        File.ReadAllBytes("图片文件路径"),
        File.ReadAllBytes("图片文件路径")
    };
	// 调用人脸比对，可能会抛出网络等异常，请使用try/catch捕获
	var result = client.Match(images);
	Console.WriteLine(result);
	// 如果有可选参数
	var options = new Dictionary<string, object>{
	    {"ext_fields", "qualities"},
	    {"image_liveness", ",faceliveness"},
	    {"types", "7,13"}
	};
	// 带参数调用人脸比对
	result = client.Match(images, options);
	Console.WriteLine(result);
}

//请求两张图片
{
    "log_id": 73473737,
    "result_num":1,
    "result": [
        {
            "index_i": 0,
            "index_j": 1,
            "score": 44.3
        }
    ]
}

public void IdentifyDemo() {
	var groupId = "group1,group2";
	
	var image = File.ReadAllBytes("图片文件路径");
	// 调用人脸识别，可能会抛出网络等异常，请使用try/catch捕获
	var result = client.Identify(groupId, image);
	Console.WriteLine(result);
	// 如果有可选参数
	var options = new Dictionary<string, object>{
	    {"ext_fields", "faceliveness"},
	    {"user_top_num", 3}
	};
	// 带参数调用人脸识别
	result = client.Identify(groupId, image, options);
	Console.WriteLine(result);
}

{
    "log_id": 73473737,
    "result_num":1,
    "result": [
        {
            "group_id" : "test1",
            "uid": "u333333",
            "user_info": "Test User",
            "scores": [
                    99.3,
                    83.4
            ]
        }
    ]
}

public void VerifyDemo() {
	var uid = "user1";
	
	var groupId = "group1,group2";
	
	var image = File.ReadAllBytes("图片文件路径");
	// 调用人脸认证，可能会抛出网络等异常，请使用try/catch捕获
	var result = client.Verify(uid, groupId, image);
	Console.WriteLine(result);
	// 如果有可选参数
	var options = new Dictionary<string, object>{
	    {"top_num", 3},
	    {"ext_fields", "faceliveness"}
	};
	// 带参数调用人脸认证
	result = client.Verify(uid, groupId, image, options);
	Console.WriteLine(result);
}

{
    "log_id": 73473737,
    "result_num":2,
    "result": [
            99.3,
            83.6
    ]
}

public void MultiIdentifyDemo() {
	var groupId = "group1,group2";
	
	var image = File.ReadAllBytes("图片文件路径");
	// 调用M:N 识别，可能会抛出网络等异常，请使用try/catch捕获
	var result = client.MultiIdentify(groupId, image);
	Console.WriteLine(result);
	// 如果有可选参数
	var options = new Dictionary<string, object>{
	    {"ext_fields", "faceliveness"},
	    {"detect_top_num", 3},
	    {"user_top_num", 2}
	};
	// 带参数调用M:N 识别
	result = client.MultiIdentify(groupId, image, options);
	Console.WriteLine(result);
}

{
    "log_id": 73473737,
    "result_num":1,
    "result": [
        {
            "group_id" : "test1",
            "uid": "u333333",
            "user_info": "Test User",
            "position":{"left":726.99188232422,"top":288.37701416016,"width":44,"height":42,"degree":-4,"prob":0.91117089986801},
            "scores": [
                    99.3
            ]
        },
        {
            "group_id" : "test1",
            "uid": "u2222222",
            "user_info": "Test User",
            "position":{"left":726.99188232422,"top":288.37701416016,"width":44,"height":42,"degree":-4,"prob":0.91117089986801},
            "scores": [
                    82.3
            ]
        }
    ]
}

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

public void UserAddDemo() {
	var uid = "user1";
	
	var userInfo = "user's info";
	
	var groupId = "group1,group2";
	
	var image = File.ReadAllBytes("图片文件路径");
	// 调用人脸注册，可能会抛出网络等异常，请使用try/catch捕获
	var result = client.UserAdd(uid, userInfo, groupId, image);
	Console.WriteLine(result);
	// 如果有可选参数
	var options = new Dictionary<string, object>{
	    {"action_type", "replace"}
	};
	// 带参数调用人脸注册
	result = client.UserAdd(uid, userInfo, groupId, image, options);
	Console.WriteLine(result);
}

// 注册成功
{
    "log_id": 73473737,
}
// 注册发生错误
{
  "error_code": 216616,
  "log_id": 674786177,
  "error_msg": "image exist"
}

public void UserUpdateDemo() {
	var uid = "user1";
	
	var userInfo = "user's info";
	
	var groupId = "group1";
	
	var image = File.ReadAllBytes("图片文件路径");
	// 调用人脸更新，可能会抛出网络等异常，请使用try/catch捕获
	var result = client.UserUpdate(uid, userInfo, groupId, image);
	Console.WriteLine(result);
	// 如果有可选参数
	var options = new Dictionary<string, object>{
	    {"action_type", "replace"}
	};
	// 带参数调用人脸更新
	result = client.UserUpdate(uid, userInfo, groupId, image, options);
	Console.WriteLine(result);
}

// 更新成功
{
    "log_id": 73473737,
}
// 更新发生错误
{
  "error_code": 216612,
  "log_id": 1137508902,
  "error_msg": "user not exist"
}

public void UserDeleteDemo() {
	var uid = "user1";
	
	// 调用人脸删除，可能会抛出网络等异常，请使用try/catch捕获
	var result = client.UserDelete(uid);
	Console.WriteLine(result);
	// 如果有可选参数
	var options = new Dictionary<string, object>{
	    {"group_id", "group1"}
	};
	// 带参数调用人脸删除
	result = client.UserDelete(uid, options);
	Console.WriteLine(result);
}

// 删除成功
{
    "log_id": 73473737,
}
// 删除发生错误
{
  "error_code": 216612,
  "log_id": 1137508902,
  "error_msg": "user not exist"
}

public void UserGetDemo() {
	var uid = "user1";
	
	// 调用用户信息查询，可能会抛出网络等异常，请使用try/catch捕获
	var result = client.UserGet(uid);
	Console.WriteLine(result);
	// 如果有可选参数
	var options = new Dictionary<string, object>{
	    {"group_id", "group1"}
	};
	// 带参数调用用户信息查询
	result = client.UserGet(uid, options);
	Console.WriteLine(result);
}

{
“result_num” : 2
    "result": {
        [
            "uid": "testuser2",
            "user_info": "registed user info ...",
            "group_id": "grep1",
        ],
        [
            "uid": "testuser2",
            "user_info": "registed user info2 ...",
            "group_id": "grep2",
        ],
    },
    "log_id": 2979357502
}

public void GroupGetlistDemo() {
	// 调用组列表查询，可能会抛出网络等异常，请使用try/catch捕获
	var result = client.GroupGetlist();
	Console.WriteLine(result);
	// 如果有可选参数
	var options = new Dictionary<string, object>{
	    {"start", 0},
	    {"num", 50}
	};
	// 带参数调用组列表查询
	result = client.GroupGetlist(options);
	Console.WriteLine(result);
}

{
    "result_num": 2,
    "result": [
        "grp1",
        "grp2"
    ],
    "log_id": 3314921889
}

public void GroupGetusersDemo() {
	var groupId = "group1";
	
	// 调用组内用户列表查询，可能会抛出网络等异常，请使用try/catch捕获
	var result = client.GroupGetusers(groupId);
	Console.WriteLine(result);
	// 如果有可选参数
	var options = new Dictionary<string, object>{
	    {"start", 0},
	    {"num", 50}
	};
	// 带参数调用组内用户列表查询
	result = client.GroupGetusers(groupId, options);
	Console.WriteLine(result);
}

{
    "log_id": 3314921889,
    "result_num": 2,
    "result": [
        {
            "uid": "uid1",
            "user_info": "user info 1"
        },
        {
            "uid": "uid2",
            "user_info": "user info 2"
        }
    ]
}

public void GroupAdduserDemo() {
	var srcGroupId = "group1";
	
	var groupId = "group1,group2";
	
	var uid = "user1";
	
	// 调用组间复制用户，可能会抛出网络等异常，请使用try/catch捕获
	var result = client.GroupAdduser(srcGroupId, groupId, uid);
	Console.WriteLine(result);
}

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

public void GroupDeleteuserDemo() {
	var groupId = "group1,group2";
	
	var uid = "user1";
	
	// 调用组内删除用户，可能会抛出网络等异常，请使用try/catch捕获
	var result = client.GroupDeleteuser(groupId, uid);
	Console.WriteLine(result);
}

// 正确返回值
{
    "log_id": 3314921889,
}
// 发生错误时返回值
{
  "error_code": 216619,
  "log_id": 815967402,
  "error_msg": "user must be in one group at least"
}

public void PersonVerifyDemo() {
	var image = File.ReadAllBytes("图片文件路径");
	var idCardNumber = "110233112299822211";
	
	var name = "张三";
	
	// 调用身份验证，可能会抛出网络等异常，请使用try/catch捕获
	var result = client.PersonVerify(image, idCardNumber, name);
	Console.WriteLine(result);
	// 如果有可选参数
	var options = new Dictionary<string, object>{
	    {"quality", "use"},
	    {"quality_conf", "{\"left_eye\": 0.6, \"right_eye\": 0.6}"},
	    {"faceliveness", "use"},
	    {"faceliveness_conf", "{\"faceliveness\": 0.834963}"},
	    {"ext_fields", "qualities"}
	};
	// 带参数调用身份验证
	result = client.PersonVerify(image, idCardNumber, name, options);
	Console.WriteLine(result);
}

{
  "result":0.03419,
  "ext_info":{
    "faceliveness":0.834963
  },
  "log_id":772889134072410
}

public void FaceverifyDemo() {
	var image = File.ReadAllBytes("图片文件路径");
	// 调用在线活体检测，可能会抛出网络等异常，请使用try/catch捕获
	var result = client.Faceverify(image);
	Console.WriteLine(result);
	// 如果有可选参数
	var options = new Dictionary<string, object>{
	    {"max_face_num", 2},
	    {"face_fields", "qualities"}
	};
	// 带参数调用在线活体检测
	result = client.Faceverify(image, options);
	Console.WriteLine(result);
}

{
    log_id: 1900901488032821,
    result_num: 1,
    result: [
        {
            rotation_angle: 10,
            yaw: 11.357421875,
            faceliveness: 8.1253347161692e-05,
            location: {
                width: 96,
                top: 73,
                height: 96,
                left: 283
            },
            qualities: {
                illumination: 211,
                occlusion: {
                    right_eye: 0,
                    left_eye: 0.039751552045345,
                    left_cheek: 0.12623985111713,
                    mouth: 0,
                    nose: 0,
                    chin: 0.037661049515009,
                    right_cheek: 0.024720622226596
                },
                completeness: 1,
                type: {
                    cartoon: 0,
                    human: 0
                },
                blur: 2.5251445032182e-11
            },
            pitch: 1.0063140392303,
            roll: 12.760620117188,
            face_probability: 1
        }
    ]
}