之前看到同事说人脸识别多么高大上之类的， 我就好奇搜索了一下， 本人是小白级别，喜欢用百度多一点，所以就使用了百度的人脸识别SDK进行研究。不得不说百度提供的完档很详细，在学习过程中很少出现不能解决的问题， 所以本人也偷个懒，把sdk文档复制下来。

　　注：貌似有个bug,我在百度语音中菜单下创建的人脸识别，然后获取API_key和Secret_key, 在学习尝试过程中， 或多或少有请求量， 但是报表中却没有任何记录， 难道是bug吗？ 我在想是不是可以无限制的调用了，作为尝试， 没去批量去测试，感兴趣的小伙伴可以试试

准备工作：

1、需要有百度账号（没有的话可以注册）

注册地址： https://login.bce.baidu.com/

注册登录之后，在“产品服务” 菜单下找到人脸识别

点击去创建自己的应用名称，其实最主要的就是 API_key  和 Secret_key

有了这些就可以进一步去看 百度提供的SDK 文档了。

这是百度的SDK地址：http://ai.baidu.com/sdk

选择自己喜欢的开发语言进行研究， 里面文档很详细， 下载中有Demo

本人采用的是C# 进行研究。

参考地址：http://ai.baidu.com/docs#/Face-Csharp-SDK/top

主要接口：

快速入门

安装人脸 C# SDK

人脸 C# SDK目录结构

Baidu.Aip
   ├── AipSdk.dll                          // 百度AI服务 windows 动态库
   ├── AipSdk.XML                          // DLL注释
   ├── Demo/                              // Demo文件夹
   └── thirdparty                         // 第三方依赖

支持平台：.Net Framework 3.5 及以上版本

使用步骤

1.在官方网站下载C# SDK压缩工具包。

2.解压后，将 AipSdk.dll 和 thirdparty 中 的dll文件添加为引用。

3.如需使用demo，将 Demo 文件夹中相关Demo文件添加至工程即可。

使用SDK

Baidu.Aip.Face是主要命名空间，基本使用方法如下：

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);
var image = File.ReadAllBytes("图片文件");
var options = new Dictionary<string, object>()
{
    {"face_fields", "beauty,age"}
};
// 过程中发生的网络失败等系统错误，将会抛出相关异常，请使用 try/catch 捕获。
var result = client.FaceDetect(image, options);

在上面代码中，常量APP_ID在百度云控制台中创建，常量API_KEY与SECRET_KEY是在创建完毕应用后，系统分配给用户的，均为字符串，用于标识用户，为访问做签名验证，可在AI服务控制台中的应用列表中查看。

注意：如您以前是百度云的老用户，其中API_KEY对应百度云的“Access Key ID”，SECRET_KEY对应百度云的“Access Key Secret”。

接口说明

人脸检测

接口描述

检测请求图片中的人脸，返回人脸位置、72个关键点坐标、及人脸相关属性信息。

检测响应速度，与图片中人脸数量相关，人脸数量较多时响应时间会有些许延长。

典型应用场景：如人脸属性分析，基于人脸关键点的加工分析，人脸营销活动等。

五官位置会标记具体坐标；72个关键点坐标也包含具体坐标，但不包含对应位置的详细位置描述。

请求说明

图片接受类型支持本地图片路径字符串，图片文件二进制数组。

举例，要对一张图片进行人脸识别，具体的人脸信息在返回的result字段中。自定的参数在options字典中：

public static void FaceDetect()
{
    var client = new Baidu.Aip.Face.Face("Api Key", "Secret Key");
    var image = File.ReadAllBytes("图片文件路径");
    var options = new Dictionary<string, object>()
    {
        {"face_fields", "beauty,age"}
    };
    var result = client.FaceDetect(image, options);
}

人脸检测 请求参数详情

返回说明

人脸比对

接口描述

该请求用于比对多张图片中的人脸相似度并返回两两比对的得分，可用于判断两张脸是否是同一人的可能性大小。

典型应用场景：如人证合一验证，用户认证等，可与您现有的人脸库进行比对验证。

说明：支持对比对的两张图片做在线活体检测

请求说明

public static void FaceMatch()
{
    var client = new Baidu.Aip.Face.Face("Api Key", "Secret Key");
    var image1 = File.ReadAllBytes("图片文件路径");
    var image2 = File.ReadAllBytes("图片文件路径");

    var images = new byte[][] {image1, image2};

    // 人脸对比
    var result = client.FaceMatch(images);
}

人脸比对请求参数：

所有图片经base64编码后的图片数据总和不超过10M。以下可选参数放在接口最后的options参数中。

返回说明

返回样例：

//请求为四张图片，第三张解析失败
{
    "log_id": 73473737,
    "result_num":3,
    "result": [
        {
            "index_i": 0,
            "index_j": 1,
            "score": 44.3
        },
        {
            "index_i": 0,
            "index_j": 3,
            "score": 89.2
        },
        {
            "index_i": 1,
            "index_j": 3,
            "score": 10.4
        }
        ……
    ]
}

人脸识别

接口描述

用于计算指定组内用户，与上传图像中人脸的相似度。识别前提为您已经创建了一个人脸库。

典型应用场景：如人脸闸机，考勤签到，安防监控等。

说明：人脸识别返回值不直接判断是否是同一人，只返回用户信息及相似度分值。

说明：推荐可判断为同一人的相似度分值为80，您也可以根据业务需求选择更合适的阈值。

请求说明

public static void FaceIdentify()
{
    var client = new Baidu.Aip.Face.Face("Api Key", "Secret Key");
    var image1 = File.ReadAllBytes("图片文件路径");

    var result = client.User.Identify(image1, new []{"groupId"}, 1, 1);
}

人脸识别请求参数详情：

返回说明

返回样例：

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

人脸认证

接口描述

用于识别上传的图片是否为指定用户，即查找前需要先确定要查找的用户在人脸库中的id。

典型应用场景：如人脸登录，人脸签到等

说明：人脸认证与人脸识别的差别在于：人脸识别需要指定一个待查找的人脸库中的组；而人脸认证需要指定具体的用户id即可，不需要指定具体的人脸库中的组；实际应用中，人脸认证需要用户或系统先输入id，这增加了验证安全度，但也增加了复杂度，具体使用哪个接口需要视您的业务场景判断。

说明：请求参数中，新增在线活体检测

请求说明

举例，要认证一张图片在指定group中是否为uid的用户：

public static void FaceVerify()
{
    var client = new Baidu.Aip.Face.Face("Api Key", "Secret Key");
    var image1 = File.ReadAllBytes("图片文件路径");

    var result = client.User.Verify(image1, "uid", new []{"groupId"}, 1);
}

人脸认证请求参数详情：

可选参数均放在接口最后的options参数中。

返回说明

返回样例：

{
  "results": [
    93.86580657959,
    92.237548828125
  ],
  "result_num": 2,
  "log_id": 1629483134
}

人脸注册

接口描述

用于从人脸库中新增用户，可以设定多个用户所在组，及组内用户的人脸图片，

典型应用场景：构建您的人脸库，如会员人脸注册，已有用户补全人脸信息等。

人脸库、用户组、用户、用户下的人脸层级关系如下所示：

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

说明：关于人脸库的设置限制

• 每个开发者账号只能创建一个人脸库；
• 每个人脸库下，用户组（group）数量没有限制；
• 每个用户组（group）下，可添加最多300000张人脸，如每个uid注册一张人脸，则最多300000个用户uid；
• 每个用户（uid）所能注册的最大人脸数量没有限制；

说明：人脸注册完毕后，生效时间最长为35s，之后便可以进行识别或认证操作。

说明：注册的人脸，建议为用户正面人脸。

说明：uid在库中已经存在时，对此uid重复注册时，新注册的图片默认会追加到该uid下，如果手动选择action_type:replace，则会用新图替换库中该uid下所有图片。

请求说明

举例，要注册一个新用户，用户id为uid，加入组id为group1, 注册成功后服务端会返回操作的logid：

public static void FaceRegister()
{
    var client = new Baidu.Aip.Face.Face("Api Key", "Secret Key");
    var image1 = File.ReadAllBytes("图片文件路径");

    var result = client.User.Register(image1, "uid", "user info here", new []{"groupId"});
}

人脸注册请求参数要求：

所有图片经base64编码后的图片数据总和不超过10M。

人脸注册返回数据参数详情：

返回说明

返回样例：

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

人脸更新

接口描述

用于对人脸库中指定用户，更新其下的人脸图像。

说明：针对一个uid执行更新操作，新上传的人脸图像将覆盖此uid原有所有图像。

说明：执行更新操作，如果该uid不存在时，会返回错误。如果添加了action_type:replace,则不会报错，并自动注册该uid，操作结果等同注册新用户。

请求说明

举例，要更新一个用户，用户id为uid， 更新成功后服务端会返回操作的logid：

public static void FaceUpdate()
 {
     var client = new Baidu.Aip.Face.Face("Api Key", "Secret Key");
     var image1 = File.ReadAllBytes("图片文件路径");

     var result = client.User.Update(image1, "uid", "groupId", "new user info");
 }

人脸更新请求参数详情：

返回说明

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

人脸删除

接口描述

用于从人脸库中删除一个用户。

人脸删除注意事项：

• 删除的内容，包括用户所有图像和身份信息；
• 如果一个uid存在于多个用户组内且没有指定group_id，将会同时将从各个组中把用户删除
• 如果指定了group_id，则只删除此group下的uid相关信息

请求说明

public static void FaceDelete()
{
    var client = new Baidu.Aip.Face.Face("Api Key", "Secret Key");
    var result = client.User.Delete("uid");
    result = client.User.Delete("uid", new []{"group1"});
}

人脸删除请求参数要求：

返回说明

人脸删除返回数据参数详情：

返回样例：

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

用户信息查询

接口描述

用于查询人脸库中某用户的详细信息。

请求说明

举例，要查询指定用户的信息：

public static void UserInfo()
 {
     var client = new Baidu.Aip.Face.Face("Api Key", "Secret Key");
     var result = client.User.GetInfo("uid");
 }

用户信息查询请求参数要求：

以下可选参数放在接口最后的options参数中。

用户信息查询返回数据参数详情：

返回样例：

{
    "result": {
        "uid": "testuser2",
        "user_info": "registed user info ...",
        "groups": [
            "grp1",
            "grp2",
            "grp3"
        ]
    },
    "log_id": 2979357502
}

组列表查询

接口描述

用于查询用户组的列表。

请求说明

举例：

public static void GroupList()
{
   var client = new Baidu.Aip.Face.Face("Api Key", "Secret Key");
   var result = client.Group.GetAllGroups(0, 100);
}

组列表查询请求参数详情：

组列表查询返回数据参数详情：

返回样例：

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

组内用户列表查询

接口描述

用于查询指定用户组中的用户列表。

请求说明

举例：

public static void GroupUsers()
{
    var client = new Baidu.Aip.Face.Face("Api Key", "Secret Key");
    var result = client.Group.GetUsers("groupId", 0, 100);
}

组内用户列表查询请求参数详情：

组内用户列表查询返回数据参数详情：

返回样例：

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

组内添加用户

接口描述

用于将已经存在于人脸库中的用户添加到一个新的组。

说明：并不是向一个指定组内添加用户，而是直接从其它组复制用户信息

请求说明

举例：

public static void GroupAddUser()
{
    var client = new Baidu.Aip.Face.Face("Api Key", "Secret Key");
    var result = client.Group.AddUser(new []{"toGroupId"}, "uid", "fromGroupId");
}

组间复制用户请求参数详情：

####返回说明

返回样例：

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

组内删除用户

接口描述

用于将用户从某个组中删除，但不会删除用户在其它组的信息。

说明：当用户仅属于单个分组时，本接口将返回错误，请使用人脸删除接口

请求说明

举例：

public static void GroupDeleteUser()
{
    var client = new Baidu.Aip.Face.Face("Api Key", "Secret Key");
    var result = client.Group.DeleteUser(new []{"groupId"}, "uid");
}

组内删除用户请求参数详情：

返回说明

返回样例：

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

错误信息

错误返回格式

若请求错误，服务器将返回的JSON文本包含以下参数：

• error_code：错误码。
• error_msg：错误描述信息，帮助理解和解决发生的错误。

错误码