更新时间：2021 年 8 月 3 日

# 服务介绍

传入一张待识别的人脸照片或人脸标识（face_token），在已有的人脸库中识别出与目标人脸最相似的一张或多张人脸，返回置信度和不同误识率下的阈值。可针对该图片中的一张或多张人脸进行搜索。用于解决“你是谁”的问题，常用于刷脸门禁、VIP客户识别等应用场景。

# 技术特色

响应快速：提供毫秒级响应速度
与人脸库完美搭配：用户提供的图片检测到的人脸可以储存在人脸库中，支持人脸库、人脸信息的增、删、改、查等操作，可用于人脸分析、人脸比对、人脸搜索等。

您可以通过人脸搜索页面进行在线体验，支持本地上传图片，测试不同人脸图片的搜索效果。

# 应用场景

刷脸门禁：创建安全可靠的人脸库，通过人脸识别和人脸搜索智能辨识进入者身份，可实现在企业、商业、住宅等入口门禁处快速刷脸通行。
考勤打卡：能够快速、准确地搜索企业人脸库中最相似的人脸，实现极速、无感知的考勤体验。
智能相册：结合人脸识别与人脸搜索，可按人脸进行照片归类，轻松完成相册整理。
公共安全管理：当有陌生人进入小区、学校等区域时可自动预警，减少安全隐患。
VIP客户识别：通过对VIP客户的人脸信息进行存储和识别，助力实现 VIP 客户服务差异化，提升用户体验。

# 业务流程设计参考

# 业务逻辑说明

实现人脸搜索功能的业务逻辑如下图所示：

客户业务系统存储用户数据库，包括用户姓名、照片、人脸标识（face_token）等字段，同时需要在 Face++ 平台上同步创建一份人脸库，两个库通过 face_token 进行关联。每次进行人脸搜索时，Face++ 仅返回 face_token，业务系统需要通过 face_token 来查找数据库确定用户身份。
注：Face++ 的人脸搜索服务，仅作为客户业务系统的一个识别模块，与上层业务无关。

# 基本流程说明

创建人脸库。
人脸库（faceset）是用来保存人脸标识（face_token）的容器。后续业务处理时，每次调用 1:N 搜索都必须指定一个人脸库。该接口返回人脸库标识 faceset_token，faceset_token是人脸库的唯一标识。
创建人脸库的流程如下：
向人脸库添加人脸。
向人脸库中添加人脸，用于后续的人脸搜索。添加人脸时，需要传入人脸标识 face_token，face_token 是Face++ 平台上一张人脸的唯一标识，需要通过调用人脸检测 API 获得。目前每个人脸库最多支持保存 1 万个 face_token，多于 1 万个人脸时需要分库处理。
业务层可动态的创建人脸库，例如将所有预订了会议室的人创建一个人脸库。
向人脸库添加人脸的流程如下：
在人脸库中进行人脸搜索。
接口需要上传一张用于搜索的照片，并指定需要搜索的人脸库。接口返回该人脸库中与照片中人脸最像的人脸标识 face_token，并给出各参考阈值，用于客户业务系统判断是不是搜索到的人。
在人脸库中进行人脸搜索的流程如下：

# 相关术语说明

人脸特征标识 (face_token)：每个检测出的人脸，都会有其唯一标识 face_token，可用于后续的人脸属性分析、人脸比对等操作。
请注意：face_token 并不会存储人脸照片。
人脸库 (faceset)：用来存放人脸标识 face_token 的数据结构。将人脸存入人脸库可以进行人脸搜索操作。
人脸库标识 (faceset_token)：是每个人脸库的唯一标识。
业务服务器：支撑客户自身业务系统并用于接入 Face++ 平台的服务器，由客户自行运维、管控。

# 接口说明

创建人脸库 API：用于人脸库的创建
添加人脸 API：在人脸库中为一个人脸添加特征标识
人脸搜索 API：在一个已有的人脸库中找出与目标人脸最相似的一张或多张人脸
相关人脸库管理 API 组说明
删除人脸 API：用于删除一个人脸库中的某些或者全部人脸
更新人脸库信息 API：用于更新一个人脸库的属性，包括“自定义标识”，“人脸集合名称”，“自定义用户信息”，“人脸库自定义标签”
获取人脸库信息 API：用于获取人脸库的属性信息
删除人脸库 API：用于删除一个人脸库
获取人脸库列表及信息 API：获取一个 API Key 下的所有人脸库信息
自定义人脸信息 API：用于给某一个人脸添加用户标识（user_id），用于人脸搜索接口返回用户身份信息

# 计费方式

人脸搜索 API 有如下 3 种计费模式：

按量计费：0.01元/次。人脸搜索 API 隶属于人脸识别 API 组，人脸识别API组并发保障 10 QPS，开通企业认证后可翻倍至 20 QPS。
包时计费：按天或按月订购，在付费时段内无限量调用，可灵活指定服务起始时间。并发数可根据实际需求开通。人脸搜索 API 隶属于人脸识别 API 组，整组共享并发数。
a. 按天：100 元 / 天 / QPS。如 5 QPS 使用 3 天，价格是 100 x 3 x 5 = 1500 元。
b. 按月（30天）：1000 元 / 月 / QPS。如 5 QPS 使用 3 个月，价格是 1000 x 3 x 5 = 15000 元。
次数包：人脸搜索 API 次数包价格采用阶梯计费模式，您可以根据业务量级购买相应的次数包，有效期为 3 年，在有效期内可灵活调用。

详细计费说明可见 API 价目表。