百度人脸识别SDK学习

　　之前看到同事说人脸识别多么高大上之类的， 我就好奇搜索了一下， 本人是小白级别，喜欢用百度多一点，所以就使用了百度的人脸识别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目录结构

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

使用步骤

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

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

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

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

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

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

接口描述

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

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

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

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

请求说明

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

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

人脸检测 请求参数详情

返回说明

接口描述

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

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

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

请求说明

人脸比对请求参数：

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

返回说明

返回样例：

接口描述

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

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

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

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

请求说明

人脸识别请求参数详情：

返回说明

返回样例：

接口描述

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

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

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

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

请求说明

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

人脸认证请求参数详情：

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

返回说明

返回样例：

接口描述

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

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

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

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

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

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

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

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

请求说明

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

人脸注册请求参数要求：

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

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

返回说明

返回样例：

接口描述

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

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

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

请求说明

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

人脸更新请求参数详情：

返回说明

接口描述

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

人脸删除注意事项：

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

请求说明

人脸删除请求参数要求：

返回说明

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

返回样例：

接口描述

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

请求说明

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

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

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

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

返回样例：

接口描述

用于查询用户组的列表。

请求说明

举例：

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

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

返回样例：

接口描述

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

请求说明

举例：

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

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

返回样例：

接口描述

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

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

请求说明

举例：

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

####返回说明

返回样例：

接口描述

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

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

请求说明

举例：

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

返回说明

返回样例：