帮助文档
人脸搜索 1:N

更新时间:2021 年 8 月 3 日

# 服务介绍

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

# 技术特色

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

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

# 应用场景

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

# 业务流程设计参考

# 业务逻辑说明

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

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

# 基本流程说明

  1. 创建人脸库。
    人脸库(faceset)是用来保存人脸标识(face_token)的容器。后续业务处理时,每次调用 1:N 搜索都必须指定一个人脸库。该接口返回人脸库标识 faceset_token,faceset_token是人脸库的唯一标识。
    创建人脸库的流程如下:

  2. 向人脸库添加人脸。
    向人脸库中添加人脸,用于后续的人脸搜索。添加人脸时,需要传入人脸标识 face_token,face_token 是Face++ 平台上一张人脸的唯一标识,需要通过调用人脸搜索 API 获得。目前每个人脸库最多支持保存 1 万个 face_token,多于 1 万个人脸时需要分库处理。
    业务层可动态的创建人脸库,例如将所有预订了会议室的人创建一个人脸库。
    向人脸库添加人脸的流程如下:

  3. 在人脸库中进行人脸搜索。
    接口需要上传一张用于搜索的照片,并指定需要搜索的人脸库。接口返回该人脸库中与照片中人脸最像的人脸标识 face_token,并给出各参考阈值,用于客户业务系统判断是不是搜索到的人。
    在人脸库中进行人脸搜索的流程如下:

# 相关术语说明

  1. 人脸特征标识 (face_token):每个检测出的人脸,都会有其唯一标识 face_token,可用于后续的人脸属性分析、人脸比对等操作。
    请注意:face_token 并不会存储人脸照片。

  2. 人脸库 (faceset):用来存放人脸标识 face_token 的数据结构。将人脸存入人脸库可以进行人脸搜索操作。

  3. 人脸库标识 (faceset_token):是每个人脸库的唯一标识。

  4. 业务服务器:支撑客户自身业务系统并用于接入 Face++ 平台的服务器,由客户自行运维、管控。

# 接口说明

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

# 计费方式

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

  1. 按量计费:0.01元/次。人脸搜索 API 隶属于人脸识别 API 组,人脸识别API组并发保障 10 QPS,开通企业认证后可翻倍至 20 QPS。

  2. 包时计费:按天或按月订购,在付费时段内无限量调用,可灵活指定服务起始时间。并发数可根据实际需求开通。人脸搜索 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 元。

  3. 次数包:人脸搜索 API 次数包价格采用阶梯计费模式,您可以根据业务量级购买相应的次数包,有效期为 3 年,在有效期内可灵活调用。

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

该文档未解决您的疑问?查看常见问题