阿里云视觉智能开放平台提供人脸人体AI服务,该服务中的大部分API都可以单独使用,人脸搜索1:N的API需要多个API调用配合使用。本文档为您介绍如何调用多个API进行人脸搜索。
开发接入流程
可以通过以下两种方式管理人脸数据库:
控制台可视化管理:登录视觉智能开放平台控制台,在人脸人体页面的快速入口中单击人脸数据库管理,进入人脸数据库可视化管理页面,支持选择数据库、新建样本、编辑标签、上传图片、搜索样本、删除样本等操作。
API 接口管理:通过调用 API 接口管理人脸数据库,适用于程序化批量操作场景。
以下为 API 调用的开发接入流程:
跨视频人脸匹配工作流
将不同视频中检测到的人脸与数据库中已有人员进行比对归类,需按顺序调用以下 4 个接口:
创建人脸数据库:调用创建人脸数据库接口创建数据库,用于存放人脸数据。每个阿里云账号最多可创建 10 个人脸数据库,单个数据库最多支持存放 5 万张人脸照片。
创建人物实体:调用添加人脸实体(
AddFaceEntity)接口为每个已知人物创建实体,获得EntityId。添加人脸数据接口要求EntityId为必填参数,因此必须先完成本步骤,否则添加人脸数据会失败。添加人脸数据:调用添加人脸数据接口,将视频帧中检测到的人脸添加到对应实体下。接口返回
FaceId和图片质量分(QualityScore),质量分过低的人脸图片会导致后续匹配失败。搜索匹配:调用人脸搜索接口,用新的人脸图片进行搜索,返回最匹配的
EntityId及置信度(Confidence)。根据返回结果,可将该人脸归类到对应人物。
调用顺序:创建人脸数据库 → 创建人物实体 → 添加人脸数据 → 搜索匹配。第 2 步为必填前置步骤,跳过会导致添加人脸数据接口调用失败。
代码开发
创建人脸数据库,详情请参见创建人脸数据库示例代码。
添加人脸样本,详情请参见添加人脸样本示例代码。
添加人脸数据,详情请参见添加人脸数据示例代码。
搜索人脸,详情请参见人脸搜索示例代码。
常见问题
该产品如何计费?
人脸搜索1:N能力中仅人脸搜索(SearchFace)接口收费,其他接口可免费调用。详情请参见计费介绍。