检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
终端节点 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 人脸识别服务的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点（Endpoint）
获取Token Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。 下载地址：FRS-API.postman_collection
调用API报错FRS.0020怎么办 问题现象 在调用人脸识别接口时，报错“FRS.0020”，子服务未开通。 该报错表示您的子服务没有开通。 产生该报错的原因有以下两种： API没有开通，就直接调用，导致报错。 开通的API与实际调用的不一致，导致报错。 解决方法 如未开通服务
开通服务 开通服务 登录人脸识别管理控制台。 根据业务需求，选择服务部署区域，开通所需服务（例如：人脸检测），单击右侧的“开通服务”。 图1 开通FRS服务 【可选】进行OBS委托授权。 调用API进行人脸的比对、检测时，可以从本地、obs、图片base64编码中读取数据。仅当您
获取项目ID/账号名 从控制台获取项目ID/账号名 登录管理控制台。 鼠标移动至用户名，在下拉列表中单击“我的凭证”。 在“我的凭证”页面，可以查看用户名、账号名，在项目列表中查看项目ID。 图1 查看项目ID 调用API获取项目ID 项目ID还可以通过调用查询指定条件下的项目信息API获取。
删除人脸库 功能介绍 删除人脸库以及其中所有的人脸。人脸库数据为用户隐私数据，该数据无备份，删除时请谨慎操作。 前提条件： 请确保您已开通人脸搜索服务。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
批量删除人脸 功能介绍 自定义筛选条件，批量删除人脸库中的符合指定条件的多张人脸。 前提条件： 请确保您已开通人脸搜索服务。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI
查询所有人脸库 功能介绍 查询当前用户所有人脸库的状态信息。 前提条件： 请确保您已开通人脸搜索服务。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v2
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 Token认证：通过Token认证通用请求。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key)加密调用请求。 Token认证 需要使用同一个Token鉴权时，可以缓存起来，避免频繁调用。
更新人脸 功能介绍 根据人脸ID（face_id）更新单张人脸信息。 前提条件： 请确保您已开通人脸搜索服务。 application/json请求的body中，请使用标准Json格式。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explore
删除人脸 功能介绍 根据指定字段删除人脸库中人脸，删除后人脸库容量会相应的释放。 前提条件： 请确保您已开通人脸搜索服务。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI
查询人脸 功能介绍 查询指定人脸库中人脸信息。 前提条件： 请确保您已开通人脸搜索服务。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v2/{proje
创建人脸库 功能介绍 创建用于存储人脸特征的人脸库。您最多可以创建10个人脸库，每个人脸库最大容量为10万个人脸特征。如有更大规格的需求请联系客服。 前提条件： 请确保您已开通人脸搜索服务。 默认情况下，一个人脸库最大可支持10万个人脸特征，一个用户最多可创建10个人脸库，最多可
静默活体检测 功能介绍 静默活体检测是基于人脸图片中可能存在的畸变、摩尔纹、反光、倒影、边框等信息，判断图片中的人脸是否来自于真人活体，进行实人检测，有效抵御纸质翻拍照、电子翻拍照以及视频翻拍等各种攻击方式。静默活体检测支持单张图片，也支持多人脸图片，当图片中有多个人脸时，会检测
人脸比对 功能介绍 人脸比对是将两个人脸进行比对，来判断是否为同一个人，返回比对置信度。如果传入的图片中包含多个人脸，选取最大的人脸进行比对。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。 约束限制： 人脸比对输入的两张图片总大小。 只支持识别JPG、PNG、JPEG、BMP格式的图片。
添加人脸 功能介绍 添加人脸到人脸库中。将单张图片中的人脸添加至人脸库中，支持添加最大人脸或所有人脸。 前提条件： 请确保您已开通人脸搜索服务。 约束限制： 只支持识别JPG、PNG、JPEG、BMP格式的图片。 application/json请求的body中，请使用标准Json格式。
人脸检测 功能介绍 人脸检测是对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。若照片中存在多张人脸，则返回所有符合条件的人脸特征信息。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。 约束限制： 只支持识别JPG、PNG、JPEG、BMP格式的图片。
人脸搜索 功能介绍 人脸搜索是指在已有的人脸库中，查询与目标人脸相似的一张或者多张人脸，并返回相应的置信度。如果图片中包含多个人脸，选取图片中检测到的最大尺寸人脸作为检索的输入。 支持传入图片或者faceID进行人脸搜索。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。
计费说明 计费项 表1 计费项信息 计费项 计费说明 人脸识别接口调用次数 调用人脸识别的接口收费，提供按调用次数按需计费的方式。 计费模式 按需计费 按照API调用次数计费，按月累计，一个自然月后次数清零重新累计。 促销活动期间，每个用户每月前2000次免费（动作活体检测、静默
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
