文档首页 > > API参考> API概览

API概览

分享
更新时间: 2019/08/27 19:08

人脸识别服务所提供的API,均符合RESTful API设计规范,如表1所示。

表1 人脸识别API

类型

API

说明

服务查询

查询服务状态

用于查询服务的开通状态。

人脸检测

人脸检测

对输入图片进行人脸检测和分析,输出人脸在图像中的位置、人脸关键点位置和人脸关键属性。

人脸比对

人脸比对

将两个人脸进行比对,来判断是否为同一个人,返回比对置信度。如果传入的图片中包含多个人脸,选取最大的人脸进行比对。

活体检测

活体检测

检测用户所传入视频中人物是否为活体,以及视频中人物的动作顺序。如果有多张人脸出现,则选取最大的人脸进行判定。

人脸搜索

人脸搜索

人脸搜索是指在已有的人脸库中,查询与目标人脸相似的一张或者多张人脸,并返回相应的置信度。

人脸库资源管理

创建人脸库

创建用于存储人脸特征的人脸库。您最多可以创建10个人脸库,每个人脸库最大容量为10万个人脸特征。如有更大规格的需求请联系客服。

查询所有人脸库

查询当前用户所有人脸库的状态信息。

查询人脸库

查询人脸库当前的状态。

删除人脸库

删除人脸库以及其中所有的人脸。

人脸资源管理

添加人脸

添加人脸到人脸库中,检测到多少张人脸,则增加多少张人脸到人脸库当中。

查询人脸

查询指定人脸库中人脸信息。

更新人脸

根据人脸ID(face_id)更新单张人脸信息。

删除人脸

指定一个字段,根据该字段删除人脸库中的一个人脸。

批量删除人脸

自定义筛选条件,批量删除人脸库中的符合指定条件的多张人脸。

人脸标签检索

添加成员人脸图片

该接口用于添加家庭或公司成员的人脸图片到人脸标签检索的人脸集。适合家庭或公司等有固定成员的人脸标签检索场景。

查询成员人脸图片

根据成员人脸图片的标签ID,可以查询已添加的正脸和辅助脸图片信息。

删除成员人脸图片

该接口会删除该人脸标签ID关联的所有信息,请谨慎使用。

端侧抓拍人脸上报

该接口用于端侧摄像头在监测到人形或异常(例如哭声等)时,抓拍人脸图片,并且录制短视频。如果是抓拍多张图片的场景,则需要多次调用该接口。

查询成员人脸标签ID列表

该接口用于用户侧应用获取标签库中生成的人脸标签ID信息,包括:标签ID和该标签匹配的人脸图片的OBS桶内路径。适合家庭或公司等有固定成员的人脸标签检索场景。

查询陌生人脸标签ID列表

该接口用于用户侧应用获取标签库中生成的人脸标签ID信息,包括:标签ID和该标签匹配的人脸图片的OBS桶内路径。适用于家庭或公司监控中对陌生人脸进行实时自动识别标签化的场景,该场景中不需要预录入人脸信息。

查询人脸标签内容信息

人脸图片建立标签后,能够为用户侧应用提供基于标签ID的查询接口,来获取标签关联的信息。

查询人形集合信息

该接口用于查询某人脸集下,某一天的识别为人形的人脸图片以及关联的视频信息。该接口主要用于监控场景,例如蒙面入室。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区