# API概览
人脸识别服务所提供的API，均符合RESTful API设计规范，如[表1]所示。
 表1人脸识别API 
| 类型                                               | API     | 说明                                                                                              |
|:---|:---|:---|
| 人脸检测                                             | 人脸检测    | 人脸检测是对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。                                                         |
| 人脸比对                                             | 人脸比对    | 人脸比对是将两个人脸进行比对，来判断是否为同一个人，返回比对置信度。如果传入的图片中包含多个人脸，选取最大的人脸进行比对。                                   |
| 活体检测   | 动作活体检测  | 通过判断视频中的人物动作与传入动作列表是否一致来识别视频中人物是否为活体。仅检测指定动作是否发生，不对人物真实性做校验，如果有多张人脸出现，则选取最大的人脸进行判定。             |
| 活体检测   | 静默活体检测  | 基于人脸图片中可能存在的畸变、摩尔纹、反光、倒影、边框等信息，判断图片中的人脸是否来自于活体，有效抵御纸质翻拍照、电子翻拍照以及视频翻拍攻击方式。静默活体检测支持单张图片，不支持多人脸图片。 |
| 人脸搜索                                             | 人脸搜索    | 人脸搜索是指在已有的人脸库中，查询与目标人脸相似的一张或者多张人脸，并返回相应的置信度。                                                    |
| 人脸库资源管理                                          | 创建人脸库   | 创建用于存储人脸特征的人脸库。您最多可以创建10个人脸库，每个人脸库最大容量为10万个人脸特征。如有更大规格的需求请联系客服。                                 |
| 人脸库资源管理                                          | 查询所有人脸库 | 查询当前用户所有人脸库的状态信息。                                                                               |
| 人脸库资源管理                                          | 查询人脸库   | 查询人脸库当前的状态。                                                                                     |
| 人脸库资源管理                                          | 删除人脸库   | 删除人脸库以及其中所有的人脸。人脸库数据为用户隐私数据，该数据无备份，删除时请谨慎操作。                                                    |
| 人脸资源管理                                           | 添加人脸    | 添加人脸到人脸库中，检测到传入的单张图片中存在多少张人脸，则增加多少张人脸到人脸库当中。                                                    |
| 人脸资源管理                                           | 查询人脸    | 查询指定人脸库中人脸信息。                                                                                   |
| 人脸资源管理                                           | 更新人脸    | 根据人脸ID（face_id）更新单张人脸信息。                                                                        |
| 人脸资源管理                                           | 删除人脸    | 根据指定字段删除人脸库中人脸。                                                                                 |
| 人脸资源管理                                           | 批量删除人脸  | 自定义筛选条件，批量删除人脸库中的符合指定条件的多张人脸。                                                                   |