检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
调用说明 人脸识别服务提供了RESTful API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题： 使用前必读
API 人脸检测 人脸比对 活体检测 人脸搜索 人脸库资源管理 人脸资源管理
x。 face_id String 人脸ID，由系统内部生成的唯一ID。 external_image_id String 人脸所在的外部图片ID。 external_fields Json 用户添加的额外字段。 父主题： 消息对象结构
计费说明 人脸识别接口调用次数 调用人脸识别的接口收费，提供按调用次数按需计费的方式。 计费模式 按需计费 按照API调用次数计费，按月累计，一个自然月后次数清零重新累计。 促销活动期间，每个用户每月前2000次免费（动作活体检测、静默活体检测不免费），具体计费价格请参见人脸识别价格详情。
等信息，用户调用API接口时，需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。 下载地址：FRS-API.postman_collection.json。 导入配置文件。 打开并登录Postman。
说明 face_id String 是 人脸ID，由系统内部生成的唯一ID。 external_image_id String 否 用户指定的图片外部ID，与当前图像绑定。用户不设置该参数时，系统会自动生成一个。该ID长度范围为[1,36]，可以包含字母、数字、中划线或者下划线，不包含其他的特殊字符。
权限管理 权限管理 创建用户组与IAM子用户 为子用户分配权限 用户登录并验证权限 FRS自定义策略
关闭服务 FRS服务开通后，如不使用，可登录控制台进行关闭。 如果您是主账户，也可以控制子用户的服务开通、关闭状态。 图1 关闭服务 图2 控制子用户的开通、关闭
计费说明 计费说明 到期与欠费
如何处理未经授权的情况 提交OBS的数据到人脸识别服务进行识别，返回未经授权：The OBS is unauthorized时，您可以通过如下步骤处理： 使用OBS中的数据时，需要授权人脸识别服务能读取OBS数据，检查是否已在人脸识别服务的管理控制台单击过“委托授权”： 如果已经授权，界面将显示为“已授权”。
状态码 表1 状态码 状态码 编码 说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如，切换到HTTP的新版本协议。 200
功能介绍 动作活体检测是通过判断视频中的人物动作与传入动作列表是否一致来识别视频中人物是否为活体，进行实人检测。如果有多张人脸出现，则选取最大的人脸进行判定。新老用户均可用该接口。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。 约束限制： 目前支持检测视频文件
权限类 使用FRS服务需要的权限 FRS是否支持IAM细粒度划分 因权限造成的调用API失败
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
QPS限流时如何增加QPS配额 问题现象 调用人脸识别API时，报错“FRS.0033”。 该报错表示您当前请求数太多，超过流控限制。 解决方法 建议控制请求策略或者进行重试。 增加QPS配额。 请参考人脸识别价格详情，按照您的需求增加QPS配额。 变更QPS规格。 登录人脸识别管理控制台。 在左侧导航栏中选择“云上服务管理”。
调用成功时无此字段。 请求示例 X-Auth-Token值获取方法请参见快速入门。 使用external_image_id（人脸所在的外部图片ID）删除人脸库中的某一人脸特征 DELETE https://{endpoint}/v2/{project_id}/face-sets/showFaceSet/faces
如何调用API 申请服务 构造请求 认证鉴权 返回结果
公共数据结构 自定义字段 sort语法 filter语法 消息对象结构
为了避免影响业务正常使用，请您在收到欠费通知后，及时前往华为云控制台费用中心进行充值。 欠费案例 欠费原因常见于以下场景： 主账号未开通人脸识别服务，但由于子账号具备开通权限，子账号自行开通服务并调用人脸识别服务接口产生扣费。 按需计费转为套餐包时，若套餐包还未生效，此时调用此服务，将按照按需计费模式计费。 用户调用额超出购买套餐配额。
修订记录 发布日期 修改说明 2021-10-21 新版SDK正式发布，旧版SDK停止维护。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
