人脸搜索1:N

更新时间:
复制 MD 格式

阿里云视觉智能开放平台提供人脸人体AI服务,该服务中的大部分API都可以单独使用,人脸搜索1:NAPI需要多个API调用配合使用。本文档为您介绍如何调用多个API进行人脸搜索。

开发接入流程

可以通过以下两种方式管理人脸数据库:

  • 控制台可视化管理:登录视觉智能开放平台控制台,在人脸人体页面的快速入口中单击人脸数据库管理,进入人脸数据库可视化管理页面,支持选择数据库、新建样本、编辑标签、上传图片、搜索样本、删除样本等操作。

  • API 接口管理:通过调用 API 接口管理人脸数据库,适用于程序化批量操作场景。

以下为 API 调用的开发接入流程:

跨视频人脸匹配工作流

将不同视频中检测到的人脸与数据库中已有人员进行比对归类,需按顺序调用以下 4 个接口:

  1. 创建人脸数据库:调用创建人脸数据库接口创建数据库,用于存放人脸数据。每个阿里云账号最多可创建 10 个人脸数据库,单个数据库最多支持存放 5 万张人脸照片。

  2. 创建人物实体:调用添加人脸实体AddFaceEntity)接口为每个已知人物创建实体,获得 EntityId添加人脸数据接口要求 EntityId 为必填参数,因此必须先完成本步骤,否则添加人脸数据会失败。

  3. 添加人脸数据:调用添加人脸数据接口,将视频帧中检测到的人脸添加到对应实体下。接口返回 FaceId 和图片质量分(QualityScore),质量分过低的人脸图片会导致后续匹配失败。

  4. 搜索匹配:调用人脸搜索接口,用新的人脸图片进行搜索,返回最匹配的 EntityId 及置信度(Confidence)。根据返回结果,可将该人脸归类到对应人物。

调用顺序:创建人脸数据库 → 创建人物实体 → 添加人脸数据 → 搜索匹配。第 2 步为必填前置步骤,跳过会导致添加人脸数据接口调用失败。

代码开发

  1. 创建人脸数据库,详情请参见创建人脸数据库示例代码

  2. 添加人脸样本,详情请参见添加人脸样本示例代码

  3. 添加人脸数据,详情请参见添加人脸数据示例代码

  4. 搜索人脸,详情请参见人脸搜索示例代码

常见问题

该产品如何计费?

人脸搜索1:N能力中仅人脸搜索(SearchFace)接口收费,其他接口可免费调用。详情请参见计费介绍