本文介绍了接入人脸检索功能的操作流程。

初次接入

如果您初次接入人脸检索功能,想快速进行测试,请参照以下步骤进行操作:
  1. 创建个体(person)。关于接口的说明,请参见新建个体
    说明 如果分组(group)不存在,创建个体的接口会自动帮您创建分组;如果分组已经存在,则该接口会将新创建的个体添加到分组中。
  2. 新增人脸图像,关于接口的说明,请参见新增人脸
    说明 人脸图像支持传递图像的HTTP或HTTPS协议的URL链接(建议您使用这种方式),也支持传递本地图片文件,具体请参见SDK示例。
  3. 从指定的分组中检索给定的人脸图像。关于接口的说明,请参见图片人脸检索
    说明 一次检索请求中只能指定一个分组,如果您需要检测多个分组,则需要多次调用该接口传递不同的分组ID。
  4. 可选:设置个体信息。如果您需要给个体添加额外的信息,可以调用此接口。关于接口的说明,请参见设置个体。在检索到对应的个体后,我们会返回您设置的相关信息。

使用限制

  • 待检索的图像中,支持出现多张人脸(默认最大支持二张人脸)。
  • 对于检索到的每一张人脸图像,默认会返回相似度最高的五个个体的ID,建议您取分值最高的个体ID作为结果使用。
  • 检索不会返回对应的图像,您需要自行存储底库的图像与个体之间的对应关系。

修改个体所属分组

如果您需要修改某个个体所属的分组,请参照以下步骤进行操作:
  1. 将个体从分组中移除。关于接口的说明,请参见移除个体组中个体
    说明 从分组中移除某个个体不会删除该个体下的任何一张图像。
  2. 将个体添加到分组。关于接口的说明,请参见添加个体到个体组
    说明 调用该接口前请确保分组已存在。如果分组不存在,则接口调用会返回错误。