旷视产品：
Face++ API
Face++提供以下四类SDK：人脸识别、人体识别、文字识别、图像识别（场景、物体）。这里只阐述人脸识别接口用法。
1.接口使用：
Face++的人脸识别接口都是底层的识别、对比、搜索、存储，与业务基本无关。
需要官网注册账号，创建应用并获得Api Key和Api Secret，所有请求必须带有这两项用来验证身份和计费。（试用账号免费使用）。
接口均为https api形式，移动SDK也是包装的https请求。
a) 识别接口： 识别图片中人脸。接口详情： https://console.faceplusplus.com.cn/documents/4888373
输入： 图片（url，文件，base64三种方式），可选传入人脸框位置，以及想要获取的结果类型等参数。Key、Secret是每个请求都带的。
输出： 请求、图片、人脸的标识，人脸信息，所用时间。人脸信息包括人脸框位置、关键点（分为106点、83点两种）以及属性（性别、年
龄、笑容、人脸姿势、模糊、眼睛状态（睁眼、眼镜、墨镜）、情绪、人脸质量、人种、颜值、嘴部状态（口罩、张开闭合）、眼球位置和视线、
皮肤状态（健康、色斑、痘、眼圈）） 。
人脸的唯一标识可以用来存储，存储之后再对同一人脸访问可以使用这个标识。
b) 对比接口：对比是否为同一个人 。接口详情： https://console.faceplusplus.com.cn/documents/4887586
输入： 两个人脸（唯一标识、图片url、文件、base64四种方式），可选传入两个人脸的人脸框位置。
输出： 可信度以及不同误识率（千一、万一、十万一）的可信度阈值，可信度超过十万分之一的可信度阈值是同一个人的几率很高，可信度
低于千分之一的可信度阈值是同一个人的几率很低，中间的可信度可以根据用户的误识率需求确定是否判定为同一个人。阈值有可能变化。
其他输出人人脸信息、唯一标识等。
c) 搜索接口：在一个FaceSet（存储）中找出最相似的一张或多张人脸。接口详情： https://console.faceplusplus.com.cn/documents/48
88381
输入： 图片（唯一标识、图片url、文件、base64四种），FaceSet的唯一标识，想要的相似的人脸数量（1-5），可选传入人脸框位置。
输出： n个可信度、不同误识率的可信度阈值，唯一标识等信息。
d) 存储接口：FaceSet是存储单位，最多10000张，可以创建多个FaceSet。 https://console.faceplusplus.com.cn/documents/4888391
总结以及参考价值：
Face++人脸信息很全。
上层业务接口与底层功能接口分离，接口有安全性校验，使用https。
提供存储能力，按存储量计费。
接口按访问次数或者计时收费。
2. Face++接口性能：
识别接口：（调用python接口）
小图片的识别300ms左右，整个网络访问在500ms左右，网络消耗200ms左右。
大图片的识别750ms左右，整个网络访问在970ms左右，网络消耗220ms左右。
比较接口： （调用python接口）
小图片的识别500ms左右，整个网络访问在700ms左右，网络消耗200ms左右。
大图片的比较1100ms左右，整个网络访问在1360ms左右，网络消耗260ms左右。
搜索接口没有测试。
总结：速度较慢，应该和功能多有关系。
3. 上层应用：
3. 上层应用：
a) Face ID：身份验证，登陆，对比。增加了活体。
b) 智能地产：人员通行、 智能零售、车辆定位、视频监控
c) 智能安防。
百度人脸识别Api
参考： http://ai.baidu.com/tech/face
1 简介
基于深度学习的人脸识别方案，准确识别图片中的人脸信息，提供人脸属性识别、关键点定位、人脸1：1比对、人脸1：N识别、活体检测等
能力
2 具体功能
2.1 人脸检测
2.1.1 功能
人脸检测：检测图片中的人脸并标记出位置信息。
人脸关键点：展示人脸的核心关键点信息，及72个关键点信息。
人脸属性值：展示人脸属性信息，如年龄、性别等。
人脸质量信息：返回人脸各部分的遮挡、光照、模糊、完整度、置信度等信息。
2.1.2 接口
检测请求图片中的人脸，返回人脸位置、72个关键点坐标、及人脸相关属性信息。
检测响应速度，与图片中人脸数量相关，人脸数量较多时响应时间会有些许延长。
| 参数 | 类型 | 必选 | 说明 |
| log_id | uint64 | 是 | 日志id |
| result_num | uint32 | 是 | 人脸数目 |
| result | object[] | 是 | 人脸属性对象的集合 |
| +age | double | 否 | 年龄。face_fields包含age时返回 |
| +beauty | double | 否 | 美丑打分，范围0-100，越大表示越美。face_fields包含beauty时返回 |
| +location | object | 是 | 人脸在图片中的位置 |
| ++left | uint32 | 是 | 人脸区域离左边界的距离 |
| ++top | uint32 | 是 | 人脸区域离上边界的距离 |
| ++width | uint32 | 是 | 人脸区域的宽度 |
| ++height | uint32 | 是 | 人脸区域的高度 |
| +face_probability | double | 是 | 人脸置信度，范围0-1 |
| +rotation_angle | int32 | 是 | 人脸框相对于竖直方向的顺时针旋转角，[-180,180] |
| +yaw | double | 是 | 三维旋转之左右旋转角[-90(左), 90(右)] |
| +pitch | double | 是 | 三维旋转之俯仰角度[-90(上), 90(下)] |
| +roll | double | 是 | 平面内旋转角[-180(逆时针), 180(顺时针)] |
| +expression | uint32 | 否 | 表情，0，不笑；1，微笑；2，大笑。face_fields包含expression时返回 |
| +expression_probability | double | 否 | 表情置信度，范围0~1。face_fields包含expression时返回 |
| +faceshape | object[] | 否 | 脸型置信度。face_fields包含faceshape时返回 |
| ++type | string | 是 | 脸型：square/triangle/oval/heart/round |
| ++probability | double | 是 | 置信度：0~1 |
| +gender | string | 否 | male、female。face_fields包含gender时返回 |
| +gender_probability | double | 否 | 性别置信度，范围0~1。face_fields包含gender时返回 |
| +glasses | uint32 | 否 | 是否带眼镜，0-无眼镜，1-普通眼镜，2-墨镜。face_fields包含glasses时返回 |
| +glasses_probability | double | 否 | 眼镜置信度，范围0~1。face_fields包含glasses时返回 |
| +landmark | object[] | 否 | 4个关键点位置，左眼中心、右眼中心、鼻尖、嘴中心。face_fields包含landmark时返回 |
| ++x | uint32 | 否 | x坐标 |
| ++y | uint32 | 否 | y坐标 |
| +landmark72 | object[] | 否 | 72个特征点位置，示例图 。face_fields包含landmark时返回 |
| ++x | uint32 | 否 | x坐标 |
| ++y | uint32 | 否 | y坐标 |
| +race | string | 否 | yellow、white、black、arabs。face_fields包含race时返回 |
| +race_probability | double | 否 | 人种置信度，范围0~1。face_fields包含race时返回 |
| +qualities | object | 否 | 人脸质量信息。face_fields包含qualities时返回 |
| ++occlusion | object | 是 | 人脸各部分遮挡的概率,[0, 1],0表示完整，1表示不完整 |
| +++left_eye | double | 是 | 左眼 |
| +++right_eye | double | 是 | 右眼 |
| +++nose | double | 是 | 鼻子 |
| +++mouth | double | 是 | 嘴 |
| +++left_cheek | double | 是 | 左脸颊 |
| +++right_cheek | double | 是 | 右脸颊 |
| +++chin | double | 是 | 下巴 |
| ++blur | double | 是 | 人脸模糊程度，[0, 1]。0表示清晰，1表示模糊 |
| ++illumination | - | 是 | 取值范围在[0,255],表示脸部区域的光照程度 |
| ++completeness | - | 是 | 人脸完整度，[0, 1]。0表示完整，1表示不完整 |
| ++type | object | 是 | 真实人脸/卡通人脸置信度 |
| +++human | - | 是 | 真实人脸置信度，[0, 1] |
| +++cartoon | - | 是 | 卡通人脸置信度，[0, 1] |
质量判断指标（当options的参数face_fields中包含qualities，返回质量判断信息）：
| 指标 | 字段与解释 | 推荐数值界限 |
| 遮挡范围 | occlusion（0~1），0为无遮挡，1是完全遮 挡 含有多个具体子字段，表示脸部多个部位 通常用作判断头发、墨镜、口罩等遮挡 |
left_eye : 0.6, #左眼被遮挡的阈值 right_eye : 0.6, #右眼被遮挡的阈值 nose : 0.7, #鼻子被遮挡的阈值 mouth : 0.7, #嘴巴被遮挡的阈值 left_check : 0.8, #左脸颊被遮挡的阈值 right_check : 0.8, #右脸颊被遮挡的阈值 chin_contour : 0.6, #下巴被遮挡阈值 |
| 模糊度范围 | Blur（0~1），0是最清晰，1是最模糊 | 小于0.7 |
| 光照范围 | illumination（0~255） 脸部光照的灰度值，0表示光照不好 以及对应客户端SDK中，YUV的Y分量 |
大于40 |
| 姿态角度 | Pitch：三维旋转之俯仰角度[-90(上), 90(下)] Roll：平面内旋转角[-180(逆时针), 180(顺时针)] Yaw：三维旋转之左右旋转角[-90(左), 90(右)] |
分别小于20度 |
| 人脸完整度 | completeness（0或1），0代表完整，1代表 不完整 |
小于0.4 |
| 人脸大小 | 人脸部分的大小 建议长宽像素值范围：80*80~200*200 |
人脸部分不小于100*100像素 |
2.1.3 场景
人脸属性分析， 基于人脸关键点的加工分析， 人脸营销活动
2.2 人脸比对
2.2.1 功能
两张人脸图片相似度对比：比对两张图片中人脸的相似度，并返回相似度分值；
多种图片类型：支持生活照、 证件照、 身份证芯片照、 带网纹照四种类型的人脸对比；
活体检测：基于图片中的破绽分析，判断其中的人脸是否为二次翻拍（举例：如用户A用手机拍摄了一张包含人脸的图片一，用户B翻拍了
图片一得到了图片二，并用图片二伪造成用户A去进行识别操作，这种情况普遍发生在金融开户、实名认证等环节。）；
质量检测：返回模糊、光照等质量检测信息，用于辅助判断图片是否符合识别要求；
2.2.2 接口
该请求用于比对多张图片中的人脸相似度并返回两两比对的得分，可用于判断两张脸是否是同一人的可能性大小。
接口名称：Json::Value match(vector<string> images,map<string,string> options)
请求参数：
| 参数名称 | 是否必选 | 类型 | 可选值范围 | 说明 |
| images | 是 | std::vector<std::string> | 图片数据的二进制字符串组成 的vector， 可以使用aip::get_file_conte nt函数获取单个图片信息，然 后加入vector容器 |
|
| options | 否 | std::map<std::string,std::str ing> |
options["ext_fields"] = "qu alities"; 返回质量信息，取值 固定:目前支持qualities(质量 检测） options["image_liveness"] = ",faceliveness"; 对第一张 图片不做活体检测、第二张图 做活体检测 options["types"] = "7,13"; 请求对比的两张图片的类型， 示例：“7,13” 12表示带水印证件照：一般 为带水印的小图，如公安网小 图7 表示生活照：通常为手机、 相机拍摄的人像图片、或从网 络获取的人像图片等 13表示证件照片：如拍摄的 身份证、工卡、护照、学生证 等证件图片， 注：需要确保人 脸部分不可太小，通常为100 px*100px| |
返回参数：
| 字段 | 必选 | 类型 | 说明 |
| log_id | 是 | uint64 | 请求唯一标识码，随机数 |
| result_num | 是 | uint32 | 返回结果数目，即：result数组中元 素个数 |
| result | 是 | array(object) | 结果数据，index和请求图片index对 应。数组元素为每张图片的匹配得分 数组，top n。 得分[0,100.0] |
| +index_i | 是 | uint32 | 比对图片1的index |
| +index_j | 是 | uint32 | 比对图片2的index |
| +score | 是 | double | 比对得分 |
| ext_info | 否 | array（dict） | 对应参数中的ext_fields |
| +qualities | 否 | string | 质量相关的信息，无特殊需求可以不 使用 |
| +faceliveness | 否 | string | 活体分数，如0.49999。单帧活体检 测参考阈值0.393241，超过此分值以 上则可认为是活体。 注意：活体检测 接口主要用于判断是否为二次翻拍， 需要限制用户为当场拍照获取图片； 推荐配合客户端SDK有动作校验活体 使用 |
2.2.3 场景
人证合一验证， 用户认证等，可与您现有的人脸库进行比对验证
2.3 人脸库管理
人脸库管理相关接口，要完成1：N或者M：N识别，首先需要构建一个人脸库，用于存放所有人脸特征
2.3.1 功能
人脸注册：向人脸库中添加人脸
人脸更新：更新人脸库中，指定用户下的人脸信息
人脸删除：删除人脸库中的某个用户
用户信息查询：查询人脸库中某个用户的详细信息
组列表查询：查询人脸库中用户组的列表
组内用户列表查询：查询指定用户组中的用户列表
组间复制用户：将已经存在于人脸库中的用户复制到一个新的组
组内删除用户：将指定用户从某个组中删除，但不会删除用户在其它组的信息
人脸库结构
人脸库、用户组、用户、用户下的人脸层级关系如下所示：
|- (appid)
|- group_id
|- 01uid
|- faceid
|- 02uid
|- faceid
|- faceid
....
....
|- group_id
|- group_id
2.3.2 接口
为了保证识别效果，请控制注册人脸的质量（通过/detect人脸检测接口判断）
2.3.2.1 人脸注册
接口名称： Json::Value user_add(std::string uid,std::string user_info,std::string group_id,std::string image,std::map<std::string,std::string>
options(可选参数))
请求参数说明：
| 参数名称 | 是否必选 | 类型 | 默认值 | 说明 |
| uid | 是 | std::string | 用户id（由数字、字母、下划 线组成），长度限制128B |
|
| user_info | 是 | std::string | 用户资料，长度限制256B |
| group_id | 是 | std::string | 用户组id，标识一组用户（由 数字、字母、下划线组成）， 长度限制128B。如果需要将 一个uid注册到多个group下 ，group_id需要用多个逗号 分隔，每个group_id长度限 制为48个英文字符。 注：gro up无需单独创建，注册用户 时则会自动创建group。 产品建议：根据您的业务需求 ，可以将需要注册的用户，按 照业务划分，分配到不同的gr oup下，例如按照会员手机尾 号作为groupid，用于刷脸支 付、会员计费消费等，这样可 以尽可能控制每个group下的 用户数与人脸数，提升检索的 准确率 |
|
| image | 是 | std::string | 图片数据的二进制字符串，可 以使用aip::get_file_content 函数获取 |
|
| action_type | 否 | std::string | append | 参数包含append、replace 。 如果为“replace”，则每 次注册时进行替换replace（ 新增或更新）操作，默认为a ppend操作。例如：uid在库 中已经存在时，对此uid重复 注册时，新注册的图片默认会 追加到该uid下，如果手动选 择action_type:replace ，则会用新图替换库中该uid 下所有图片。 |
返回信息说明：
| 字段 | 是否必选 | 类型 | 说明 |
| log_id | 是 | uint64 | 请求唯一标识码，随机数 |
| error_code | 否 | uint64 | 注册失败时的错误码 |
| error_msg | 否 | string | 错误信息 |
2.3.2.2 人脸更新（不支持增量更新）
用于对人脸库中指定用户，更新其下的人脸图像。
**说明：**针对一个uid执行更新操作，新上传的人脸图像将覆盖此uid原有所有图像。
**说明：**执行更新操作，如果该uid不存在时，会返回错误。如果添加了action_type:replace,则不会报错，并自动注册该uid，
操作结果等同注册新用户。
接口名称： Json::Value user_update(std::string uid,std::string user_info,std::string group_id,std::string
image,std::map<std::string,std::string> options(可选参数))
请求参数说明：
| 参数名称 | 是否必选 | 类型 | 默认值 | 说明 |
| uid | 是 | std::string | 用户id（由数字、字母、下划 线组成），长度限制128B |
|
| user_info | 是 | std::string | 用户资料，长度限制256B | |
| group_id | 是 | std::string | 更新指定groupid下uid对应 的信息 |
| image | 是 | std::string | 图片数据的二进制字符串，可 以使用aip::get_file_content 函数获取 |
|
| action_type | 否 | std::string | append | 目前仅支持replace，uid不存 在时，不报错，会自动变为注 册操作；未选择该参数时，如 果uid不存在会提示错误 |
返回信息说明：
| 字段 | 是否必选 | 类型 | 说明 |
| log_id | 是 | uint64 | 请求唯一标识码，随机数 |
| error_code | 否 | uint64 | 注册失败时的错误码 |
| error_msg | 否 | string | 错误信息 |
2.3.2.3 人脸删除
用于从人脸库中删除一个用户。
人脸删除注意事项：
删除的内容，包括用户所有图像和身份信息；
如果一个uid存在于多个用户组内，将会同时将从各个组中把用户删除
如果指定了group_id，则只删除此group下的uid相关信息
接口名称： Json::Value user_delete(std::string uid,std::map<std::string,std::string> options)
options["group_id"] = "group1";
请求参数说明：
| 参数名称 | 是否必选 | 类型 | 说明 |
| uid | 是 | std::string | 用户id（由数字、字母、下划线组成），长度限制128B |
| group_id | 否 | std::string | 删除指定groupid下uid对应的信息 |
返回信息说明：
| 字段 | 是否必选 | 类型 | 说明 |
| log_id | 是 | uint64 | 请求唯一标识码，随机数 |
| error_code | 否 | uint64 | 注册失败时的错误码 |
| error_msg | 否 | string | 错误信息 |
2.3.2.4 用户信息查询
用于查询人脸库中某用户的详细信息。
接口名称： Json::Value user_get(std::string,std::map<std::string,std::string> options)
options["group_id"] = "group1";
请求参数说明：
| 参数名称 | 是否必选 | 类型 | 说明 |
| uid | 是 | std::string | 用户id（由数字、字母、下划线组成），长度限制128B |
| group_id | 否 | std::string | 选择指定group_id则只查找group列表下的uid内容，如果不指定则查找所有group下对应uid的信息 |
返回信息说明：
| 字段 | 是否必选 | 类型 | 说明 |
| log_id | 是 | uint64 | 请求标识码，随机数，唯一 |
| result | 是 | array(double) | 结果数组 |
| +uid | 是 | string | 匹配到的用户id |
| +user_info | 是 | string | 注册时的用户信息 |
| +groups | 是 | array(string) | 用户所属组列表 |
2.3.2.5 组列表查询
用于查询用户组的列表。
接口名称：Json::Value group_getlist(std::map<std::string, std::string> options)
options["start"] = "0"; options["num"] = "50";
请求参数说明：
| 参数名称 | 是否必选 | 类型 | 默认值 | 说明 |
| start | 否 | std::string | 0 | 默认值0，起始序号 |
| num | 否 | std::string | 100 | 返回数量，默认值100，最大值1000 |
返回信息说明：
| 字段 | 是否必选 | 类型 | 说明 |
| result_num | 是 | number | 返回个数 |
| result | 是 | array(string) | group_id列表 |
2.3.2.6 组内用户列表查询
用于查询指定用户组中的用户列表。
接口名称：Json::Value group_getusers(std::string group_id,std::map<std::string,std::string> options)
options["start"] = "0"; options["num"] = "50"
请求参数说明：
| 参数名称 | 是否必选 | 类型 | 默认值 | 说明 |
| group_id | 是 | std::string | 用户组id（由数字、字母、下划线组成），长度限制128B | |
| start | 否 | std::string | 0 | 默认值0，起始序号 |
| num | 否 | std::string | 100 | 返回数量，默认值100，最大值1000 |
返回信息说明：
| 字段 | 是否必选 | 类型 | 说明 |
| log_id | 是 | uint64 | 请求标识码，随机数，唯一 |
| result_num | 是 | uint32 | 返回个数 |
| result | 是 | array(object) | user列表 |
| +uid | 是 | string | 用户id |
| +user_info | 是 | string | 用户信息 |
2.3.2.7 组间复制用户
用于将已经存在于人脸库中的用户复制到一个新的组。
说明：并不是向一个指定组内添加用户，而是直接从其它组复制用户信息 如果需要注册用户，请直接使用人脸注册接口
接口名称： Json::Value group_adduser(std::string src_group_id,std::string group_id,std::string uid,std::map<std::string,std::string>
options)
请求参数说明：
| 参数名称 | 是否必选 | 类型 | 说明 |
| src_group_id | 是 | std::string | 从指定group里复制信息 |
| group_id | 是 | std::string | 用户组id，标识一组用户（由数字、 字母、下划线组成），长度限制128B 。如果需要将一个uid注册到多个gro up下，group_id需要用多个逗号分隔 ，每个group_id长度限制为48个英文 字符。 注：group无需单独创建，注 册用户时则会自动创建group。 产品建议：根据您的业务需求，可以 将需要注册的用户，按照业务划分， 分配到不同的group下，例如按照会 员手机尾号作为groupid，用于刷脸 支付、会员计费消费等，这样可以尽 可能控制每个group下的用户数与人 脸数，提升检索的准确率 |
| uid | 是 | std::string | 用户id（由数字、字母、下划线组成 ），长度限制128B |
返回信息说明：
| 字段 | 是否必选 | 类型 | 说明 |
| log_id | 是 | uint64 | 请求唯一标识码，随机数 |
| error_code | 否 | uint64 | 注册失败时的错误码 |
| error_msg | 否 | string | 错误信息 |
2.3.2.8 组内删除用户
用于将用户从某个组中删除，但不会删除用户在其它组的信息。
说明：当用户仅属于单个分组时，本接口将返回错误，请使用人脸删除接口
接口名称：Json::Value group_deleteuser(std::string group_id,std::string uid,std::map<std::string,std::string> options)
请求参数说明：
| 参数名称 | 是否必选 | 类型 | 说明 |
| group_id | 是 | std::string | 用户组id，标识一组用户（由数字、 字母、下划线组成），长度限制128B 。如果需要将一个uid注册到多个gro up下，group_id需要用多个逗号分隔 ，每个group_id长度限制为48个英文 字符。 注：group无需单独创建，注 册用户时则会自动创建group。 产品建议：根据您的业务需求，可以 将需要注册的用户，按照业务划分， 分配到不同的group下，例如按照会 员手机尾号作为groupid，用于刷脸 支付、会员计费消费等，这样可以尽 可能控制每个group下的用户数与人 脸数，提升检索的准确率 |
| uid | 是 | std::string | 用户id（由数字、字母、下划线组成 ），长度限制128B |
返回信息说明：
| 字段 | 是否必选 | 类型 | 说明 |
| log_id | 是 | uint64 | 请求唯一标识码，随机数 |
| error_code | 否 | uint64 | 注册失败时的错误码 |
| error_msg | 否 | string | 错误信息 |
2.3.3 场景
构建您的人脸库，如会员人脸注册， 已有用户补全人脸信息等。
2.4 人脸查找
2.4.1 功能
1：N人脸识别：也称为1：N识别，在指定人脸集合中，找到最相似的人脸；
1：N人脸认证：基于uid维度的1：N识别，由于uid已经锁定固定数量的人脸，所以检索范围更聚焦；
M：N多人脸识别：也称为M：N识别，待识别图片中含有多个人脸时，在指定人脸集合中，找到这多个人脸分别最相似的人脸；
2.4.2 接口
2.4.2.1 1:N人脸识别
用于计算指定组内用户，与上传图像中人脸的相似度。识别前提为您已经创建了一个人脸库。
**说明：**人脸识别返回值不直接判断是否是同一人，只返回用户信息及相似度分值。
说明：推荐可判断为同一人的相似度分值为80，您也可以根据业务需求选择更合适的阈值。
接口名称: Json::Value identify(std::string group_id,std::string image,std::map<std::string,std::string> options)
options["ext_fields"] = "faceliveness"; options["user_top_num"] = "3";请求参数说明：
| 参数名称 | 是否必选 | 类型 | 默认值 | 说明 |
| group_id | 是 | std::string | 用户组id，标识一组用户（由 数字、字母、下划线组成）， 长度限制128B。如果需要将 一个uid注册到多个group下 ，group_id需要用多个逗号 分隔，每个group_id长度限 制为48个英文字符。 注：gro up无需单独创建，注册用户 时则会自动创建group。 产品建议：根据您的业务需求 ，可以将需要注册的用户，按 照业务划分，分配到不同的gr oup下，例如按照会员手机尾 号作为groupid，用于刷脸支 付、会员计费消费等，这样可 以尽可能控制每个group下的 用户数与人脸数，提升检索的 准确率 |
|
| image | 是 | std::string | 图片数据的二进制字符串，可 以使用aip::get_file_content 函数获取 |
|
| ext_fields | 否 | std::string | 特殊返回信息，多个用逗号分 隔，取值固定: 目前支持faceliveness(活体 检测)。 注：需要用于判断活 体的图片，图片中的人脸像素 面积需要不小于100px*100p x，人脸长宽与图片长宽比例 ，不小于1/3 |
|
| user_top_num | 否 | std::string | 1 | 返回用户top数，默认为1， 最多返回5个 |
返回信息说明：
| 字段 | 必选 | 类型 | 说明 |
| log_id | 是 | uint64 | 请求唯一标识码，随机数 |
| result_num | 是 | uint32 | 返回结果数目，即：result数组中元 素个数 |
| ext_info | 否 | array | 对应参数中的ext_fields |
| +faceliveness | 否 | string | 活体分数，如0.49999。单帧活体检 测参考阈值0.393241，超过此分值以 上则可认为是活体。 注意：活体检测 接口主要用于判断是否为二次翻拍， 需要限制用户为当场拍照获取图片； 推荐配合客户端SDK有动作校验活体 使用 |
| result | 是 | array(object) | 结果数组 |
| +group_id | 是 | string | 对应的这个用户的group_id |
| +uid | 是 | string | 匹配到的用户id |
| +user_info | 是 | string | 注册时的用户信息 |
| +scores | 是 | array(double) | 结果数组，数组元素为匹配得分，to p n。得分[0,100.0] |
2.4.2.2 1:N人脸认证用于识别上传的图片是否为指定用户，即查找前需要先确定要查找的用户在人脸库中的id。接口名称：Json::Value verify(std::string uid,std::string group_id,std::string image,std::map<std::string,std::string> options)options["top_num"] = "3"; options["ext_fields"] = "faceliveness";请求参数说明：
| 参数名称 | 是否必选 | 类型 | 默认值 | 说明 |
| uid | 是 | std::string | 用户id（由数字、字母、下划 线组成），长度限制128B |
|
| group_id | 是 | std::string | 用户组id，标识一组用户（由 数字、字母、下划线组成）， 长度限制128B。如果需要将 一个uid注册到多个group下 ，group_id需要用多个逗号 分隔，每个group_id长度限 制为48个英文字符。 注：gro up无需单独创建，注册用户 时则会自动创建group。 产品建议：根据您的业务需求 ，可以将需要注册的用户，按 照业务划分，分配到不同的gr oup下，例如按照会员手机尾 号作为groupid，用于刷脸支 付、会员计费消费等，这样可 以尽可能控制每个group下的 用户数与人脸数，提升检索的 准确率 |
|
| image | 是 | std::string | 图片数据的二进制字符串，可 以使用aip::get_file_content 函数获取 |
|
| top_num | 否 | std::string | 1 | 返回用户top数，默认为1 |
| ext_fields | 否 | std::string | 特殊返回信息，多个用逗号分 隔，取值固定: 目前支持faceliveness(活体 检测)。 注：需要用于判断活 体的图片，图片中的人脸像素 面积需要不小于100px*100p x，人脸长宽与图片长宽比例 ，不小于1/3 |
返回信息说明：
| 字段 | 必选 | 类型 | 说明 |
| log_id | 是 | uint64 | 请求唯一标识码，随机数 |
| result_num | 是 | uint32 | 返回结果数目，即：result数组中元 素个数 |
| result | 是 | array(double) | 结果数组，数组元素为匹配得分，to p n。 得分范围[0,100.0]。推荐得分超过80 可认为认证成功 |
| ext_info | 否 | array | 对应参数中的ext_fields |
| +faceliveness | 否 | string | 活体分数，如0.49999。单帧活体检 测参考阈值0.393241，超过此分值以 上则可认为是活体。 活体检测接口主 要用于判断是否为二次翻拍，需要限 制用户为当场拍照获取图片；推荐配 合客户端SDK有动作校验活体使用 |
2.4.2.3 M:N多人脸识别待识别的图片中，存在多张人脸的情况下，支持在一个人脸库中，一次请求，同时返回图片中所有人脸的识别结果。接口名称：Json::Value multi_identify(std::string group_id,std::string image,std::map<std::string,std::string> options)options["ext_fields"] = "faceliveness"; options["detect_top_num"] = "3"; options["user_top_num"] = "2";请求参数说明：
| 参数名称 | 是否必选 | 类型 | 默认值 | 说明 |
| group_id | 是 | std::string | 用户组id，标识一组用户（由数字、字母、下划线组成）， 长度限制128B。如果需要将 一个uid注册到多个group下 ，group_id需要用多个逗号 分隔，每个group_id长度限 制为48个英文字符。 注：gro up无需单独创建，注册用户 时则会自动创建group。 产品建议：根据您的业务需求 ，可以将需要注册的用户，按 照业务划分，分配到不同的gr oup下，例如按照会员手机尾 号作为groupid，用于刷脸支 付、会员计费消费等，这样可 以尽可能控制每个group下的 用户数与人脸数，提升检索的 准确率 |
|
| image | 是 | std::string | 图片数据的二进制字符串，可以使用aip::get_file_content 函数获取 |
|
| ext_fields | 否 | std::string | 特殊返回信息，多个用逗号分隔，取值固定: 目前支持faceliveness(活体 检测)。 注：需要用于判断活 体的图片，图片中的人脸像素 面积需要不小于100px*100p x，人脸长宽与图片长宽比例 ，不小于1/3 |
|
| detect_top_num | 否 | std::string | 1 | 检测多少个人脸进行比对，默认值1（最对返回10个） |
| user_top_num | 否 | std::string | 1 | 返回识别结果top人数”，当同一个人有多张图片时，只返 回比对最高的1个分数（即， scores参数只有一个值），默 认为1（最多返回20个） |
返回信息说明：
| 参数 | 字段 | 必选 | 类型 | 说明 |
| log_id | - | 是 | uint32 | 请求标识码，随机数，唯一 |
| result_num | - | 是 | float | 返回结果数目，即：result数组中元素个数（PS：最终返回的个数是小于等于“实际检测到的人脸数” *“每个人脸匹配的top人数”） |
| ext_info | - | 否 | array | 对应参数中的ext_fields |
| - | faceliveness | 否 | string | 活体检测分数，单帧活体检测参考阈值0.393241，超过此分值以上则可认为是活体。 注意：活体检测接口主要用于判断是否为二次翻拍，需要限制用户为当场拍照获取图片；推荐配合客户端SDK有动作校验活体使用 |
| result | - | 是 | array(object) | - |
| - | group_id | 是 | string | 对应的这个用户的group_id |
| - | uid | 是 | string | 匹配到的用户id |
| - | user_info | 是 | string | 注册时的用户信息 |
| - | scores | 是 | array(double) | 结果数组，数组元素为匹配得分，得分[0,100.0]；个数取决于user_top_num的设定。推荐80分以上即可判断为同一人 |
| - | position | 是 | object | 人脸位置，如{top:111,left:222,width:333,height:444,degree:20} |
2.4.3 场景如人脸闸机， 考勤签到， 安防监控等。百度人脸识别API目前主要用于以下场景：远程身份认证：人脸比对门禁考勤：人脸查找安防监控：人脸查找智能相册分类：人脸检测、人脸查找人脸美颜：人脸检测
