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

初次接入

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


使用限制

  • 待检索的图像中，支持出现多张人脸（默认最大支持二张人脸）。如果您需要检索超过二张人脸的图像，请通过工单联系我们调整。
  • 对于检索到的每一张人脸图像，默认会返回相似度最高的五个个体的ID，建议您取分值最高的个体ID作为结果使用。如果五个结果不能满足您的需求，您可以通过工单联系我们调整。
  • 检索不会返回对应的图像，您需要自行存储底库的图像与个体之间的对应关系。

修改个体所属分组

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