喜讯：国内、香港、海外云服务器租用特惠活动，2核/4G/10M仅需31元每月，点击抢购>>>
点击这里申请百度智能云特邀VIP帐号，立即体验人脸识别>>>
百度人脸识别使用指南-私有化部署接口文档
1.总体说明
私有化部署包部署成功后，即可获得与公有云基本完全相同的接口，人脸识别的相关接口将会启动，即可开始调用。
1.1 接口能力
在私有化部署包中会提供如下5类接口：
Appid管理
业务能力
创建Appid：用于创建一个Appid
查询Appid：用于查询此业务中已经创建哪个Appid
注：创建方式为：通过调用“创建用户组”接口来创建appid，即：在“创建用户组”接口中可以自定义一个Appid，当组创建成功后，此Appid即可生效。
人脸检测与属性分析
接口能力
① 人脸检测：检测图片中的人脸并标记出位置信息;
② 人脸关键点：展示人脸的核心关键点信息，及72个关键点信息;
③ 人脸属性值：展示人脸属性信息，如年龄、性别等;
④ 人脸质量信息：返回人脸各部分的遮挡、光照、模糊、完整度、置信度等信息。
典型应用场景：如人脸属性分析，基于人脸关键点的加工分析，人脸营销活动等。
人脸比对
接口能力
① 两张人脸图片相似度对比：比对两张图片中人脸的相似度，并返回相似度分值；
② 多种图片类型：支持生活照、证件照、身份证芯片照、带网纹照四种类型的人脸对比；
③ 活体检测控制：基于图片中的破绽分析，判断其中的人脸是否为二次翻拍（举例：如用户A用手机拍摄了一张包含人脸的图片一，用户B翻拍了图片一得到了图片二，并用图片二伪造成用户A去进行识别操作，这种情况普遍发生在金融开户、实名认证等环节。）；
④ 质量检测控制：分析图片的中人脸的模糊度、角度、光照强度等特征，判断图片质量；
业务应用
用于比对多张图片中的人脸相似度并返回两两比对的得分，可用于判断两张脸是否是同一人的可能性大小。
典型应用场景：如人证合一验证，用户认证等，可与您现有的人脸库进行比对验证。
人脸搜索
业务能力
① 1：N人脸搜索：也称为1：N识别，在指定人脸集合中，找到最相似的人脸；
② 1：N人脸认证：基于uid维度的1：N识别，由于uid已经锁定固定数量的人脸，所以检索范围更聚焦；
1：N人脸识别与1：N人脸认证的差别在于：人脸搜索是在指定人脸集合中进行直接地人脸检索操作，而人脸认证是基于uid，先调取这个uid对应的人脸，再在这个uid对应的人脸集合中进行检索（因为每个uid通常对应的只有一张人脸，所以通常也就变为了1：1对比）；实际应用中，人脸认证需要用户或系统先输入id，这增加了验证安全度，但也增加了复杂度，具体使用哪个接口需要视您的业务场景判断。
提示：进行人脸查找相关操作前，建议先阅读人脸库管理相关内容。
人脸库管理
业务能力
要完成1：N或者M：N识别，首先需要构建一个人脸库，用于存放所有人脸特征，相关接口如下：
人脸注册：向人脸库中添加人脸
① 人脸更新：更新人脸库中指定用户下的人脸信息
② 人脸删除：删除指定用户的某张人脸
③ 用户信息查询：查询人脸库中某个用户的详细信息
④ 获取用户人脸列表：获取某个用户组中的全部人脸列表
⑤ 获取用户列表：查询指定用户组中的用户列表
⑥ 复制用户：将指定用户复制到另外的人脸组
⑦ 创建用户组：创建一个新的用户组
⑧ 删除用户组：删除指定用户组
⑨ 组列表查询：查询人脸库中用户组的列表
人脸库结构
人脸库、用户组、用户、用户下的人脸层级关系如下所示：
|- 人脸库(appid) |- 用户组一（group_id） |- 用户01（uid） |- 人脸（faceid） |- 用户02（uid） |- 人脸（faceid） |- 人脸（faceid） .... .... |- 用户组二（group_id） |- 用户组三（group_id） ....
关于人脸库的设置限制
① 每个私有化部署包建议对应1个appid，每个appid对应一个人脸库；
② 每个人脸库下，可以创建多个用户组，用户组（group）数量没有限制；
③ 每个用户组（group）下，可添加无限个user_id，无限张人脸（注：为了保证查询速度，单个group中的人脸容量上限建议为80万）；
④ 每个用户（user_id）所能注册的最大人脸数量没有限制；
提醒：每个人脸库对应一个appid，一定不要轻易删除appid，删除后则此人脸库将失效，无法进行查找！
1.2 接口格式说明
变量类型定义
| 类型 | 定义 |
|---|---|
| string | 普通的字符串，可能会有长度要求，具体参见接口说明中的备注 |
| uint32 | 整形数字，最大取值为4字节int。自然数 |
| int64 | 整形数字，最大取值为8字节int。允许负数 |
| json | 无论是request还是response中某个字段定义为json，那么它其实是一个json格式的字符串，需要二次解析 |
| array | request的query中表示array请使用key[] 。response的json中的array即为jsonArray |
| double | 双精度，小数点后最大8位四舍五入 |
| encryption | 加密格式，一般用于人脸服务各模块间交互数据使用。 |
注意事项
① 所有ID定义必须为小于等于32字节的数字字母组合，尽量使用无意义的组合，并且不可以使用系统保留关键字：all、self、me、this、next。
② 所有接口POSTDATA 应当小于等于8M。
③ 单个group中的图片容量上限建议为80万
④ 人脸图片需要人脸像素在100x100以上，否则可能检测不出来人脸
请求方式
请求方式统一使用application/json请求 直接请求
直接请求时需要将appid参数拼接在请求url中，不要放在json body中 注意：如果是直接对线上单台机器发起请求，需要在接口路径前加上/api的前缀
返回格式
① error_code、error_msg即错误码和错误描述，详细含义请参考错误码表, error_code为0代表请求成功
② result是接口返回的详细信息, 格式为数组;
③ log_id是请求的日志id, 13位长(bigint), 用于定位请求。
{ "error_code" : 0, //错误码 0代表成功 "error_msg" : "SUCCESS", //错误信息 "result" : {...} //返回结果 具体内容详见相关接口 "log_id" : 3535325235 //请求的日志id "timestamp" : 1512391548 //请求到达的时间戳 精确到秒级 "cached" : 0 //未启用 无需处理 }阈值说明
遮挡情况的阈值
| 控制度 | left_eye | right_eye | nose | mouth | left_cheek | right_cheek | chin_contour |
|---|---|---|---|---|---|---|---|
| LOW | 0.8 | 0.8 | 0.8 | 0.8 | 0.8 | 0.8 | 0.8 |
| NORMAL | 0.6 | 0.6 | 0.6 | 0.6 | 0.6 | 0.6 | 0.6 |
| HIGH | 0.2 | 0.2 | 0.2 | 0.2 | 0.2 | 0.2 | 0.2 |
模糊度、完整度的阈值
湘公网安备43019002001857号
备案号：
客服1 