检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
人脸资源管理 添加人脸 查询人脸 更新人脸 删除人脸 批量删除人脸 父主题： API
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
权限类 使用FRS服务需要的权限 FRS是否支持IAM细粒度划分 因权限造成的调用API失败
修订记录 发布日期 修改说明 2021-10-21 新版SDK正式发布，旧版SDK停止维护。
WarningList 功能介绍 视频活体检测警告信息。 参数说明 表1 结构格式说明 名称 类型 说明 warningCode Integer 警告ID。 warningMsg String 警告消息。 表2 错误提示 warningCode warningMsg 1 人脸没有朝向前方。
活体检测 动作活体检测 静默活体检测 父主题： API
如何在含有多张人脸的图片中实现多人脸识别 人脸识别是否可使用证件类照片 如何处理未经授权的情况 为什么会出现识别错误的情况 为什么人脸识别通过率低 为什么会请求响应过慢 人脸检测接口可以免费调多少次 如何关闭已申请的服务 调用静默活体检测API，为什么在服务管理页面看不到调用量 人脸识别服务是否支持私有化部署
购买QPS套餐包 按需计费模式的API无法调用 为了避免影响业务正常使用，请您在收到欠费通知后，及时前往华为云控制台费用中心进行充值。 欠费案例 欠费原因常见于以下场景： 主账号未开通人脸识别服务，但由于子账号具备开通权限，子账号自行开通服务并调用人脸识别服务接口产生扣费。 按需计费转为套餐包
（错误码区间：401～500） 400 FRS.0401 找不到对应类型的值，无法删除。 请参考人脸资源管理接口说明。 400 FRS.0402 输入的字段不存在。 请参考人脸资源管理接口说明。 400 FRS.0403 Face ID不存在。 请检查输入的Face ID是否存在。 400 FRS.0404 未检测到人脸，无法添加。
调用SDK实现人脸检测 人脸识别服务软件开发工具包（FRS SDK）是对人脸识别服务提供的REST API进行的封装，以简化用户的开发工作。 本章节以人脸检测API为例，介绍如何使用FRS Python SDK。 使用FRS SDK的详细步骤如下所示： 步骤1：开通服务 步骤2：安装SDK
如何调用API 申请服务 构造请求 认证鉴权 返回结果
人脸库资源管理 创建人脸库 查询所有人脸库 查询人脸库 删除人脸库 父主题： API
0万个人脸特征。如需扩容单个人脸库规模，请联系华为云客服确认扩容规模与价格。 application/json请求的body中，请使用标准Json格式。 Base64编码中请勿使用回车换行。 系统不保存用户图片或视频。 人脸检测/比对/搜索 人脸比对输入的两张图片总大小小于8MB。
公共数据结构 自定义字段 sort语法 filter语法 消息对象结构
状态码 表1 状态码 状态码 编码 说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如，切换到HTTP的新版本协议。 200
请确保您已开通人脸搜索服务。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI DELETE /v2/{project_id}/face-sets/{face_set_name}/faces
OBS上存储的图片也建议小于1MB。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v2/{project_id}/face-sets/{face_set_name}/faces
取Token。 FRS.0020子服务未开通 在调用人脸识别接口时，报错“FRS.0020”，子服务未开通。该报错表示您的子服务没有开通，或url填写错误。 如未开通服务请登录人脸识别服务控制台人脸识别服务控制台选择“开通服务”。 如已经开通服务，请检查调用接口的请求地址是否正确。
统计API使用量 FRS控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包，可在“云上服务管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
申请服务 在调用API之前，必须先申请开通服务，下面是申请服务的相关步骤。 申请服务前，必须先注册云账号，并完成实名认证。 申请步骤 登录人脸识别管理控制台。 根据业务需求，选择服务部署区域，开通所需服务（例如：人脸检测），单击右侧的“开通服务”。 香港、曼谷区域API也可以使用中国
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
