人脸检索使用概述

本文介绍了接入人脸检索功能的操作流程和计费信息。

初次接入

如果您初次接入人脸检索功能,想快速进行测试,请参照以下步骤进行操作:

  1. 创建个体(person)。关于接口的说明,请参见新建个体

    说明

    如果分组(group)不存在,创建个体的接口会自动帮您创建分组;如果分组已经存在,则该接口会将新创建的个体添加到分组中。

  2. 新增人脸图像,关于接口的说明,请参见新增人脸

    说明

    人脸图像支持传递图像的HTTP或HTTPS协议的URL链接(建议您使用这种方式),也支持传递本地图片文件,具体请参见SDK示例。

  3. 从指定的分组中检索给定的人脸图像。关于接口的说明,请参见图片人脸检索

    说明

    一次检索请求中只能指定一个分组,如果您需要检测多个分组,则需要多次调用该接口传递不同的分组ID。

  4. 可选:设置个体信息。如果您需要给个体添加额外的信息,可以调用此接口。关于接口的说明,请参见设置个体。在检索到对应的个体后,我们会返回您设置的相关信息。

使用限制

  • 待检索的图像中,支持出现多张人脸(支持M:N功能),默认最大支持二十张人脸。

  • 对于检索到的每一张人脸图像,默认会返回相似度最高的五个个体的ID,建议您取分值最高的个体ID作为结果使用。

  • 检索不会返回对应的图像,您需要自行存储底库的图像与个体之间的对应关系。

修改个体所属分组

如果您需要修改某个个体所属的分组,请参照以下步骤进行操作:

  1. 将个体从分组中移除。关于接口的说明,请参见移除个体组中个体

    说明

    从分组中移除某个个体不会删除该个体下的任何一张图像。

  2. 将个体添加到分组。关于接口的说明,请参见添加个体到个体组

    说明

    调用该接口前请确保分组已存在。如果分组不存在,则接口调用会返回错误。

计费说明

该接口为收费接口。关于计费方式,请参见内容安全产品定价

说明

对于人脸检索功能,会对图片人脸检索新增人脸接口进行计费,其他接口免费。