检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
申请服务 在调用API之前，必须先申请开通服务，下面是申请服务的相关步骤。 申请服务前，必须先注册云账号，并完成实名认证。 申请步骤 登录人脸识别管理控制台。 根据业务需求，选择服务部署区域，开通所需服务（例如：人脸检测），单击右侧的“开通服务”。 香港、曼谷区域API也可以使用中国
等信息，用户调用API接口时，需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。 下载地址：FRS-API.postman_collection.json。 导入配置文件。 打开并登录Postman。
API 人脸检测 人脸比对 活体检测 人脸搜索 人脸库资源管理 人脸资源管理
关闭服务 FRS服务开通后，如不使用，可登录控制台进行关闭。 如果您是主账户，也可以控制子用户的服务开通、关闭状态。 图1 关闭服务 图2 控制子用户的开通、关闭
参数说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64。 actions List 动作列表。详细参数请参见表 字段要素说明。 表2 actions字段要素说明 名称 类型 说明 action
如何处理未经授权的情况 提交OBS的数据到人脸识别服务进行识别，返回未经授权：The OBS is unauthorized时，您可以通过如下步骤处理： 使用OBS中的数据时，需要授权人脸识别服务能读取OBS数据，检查是否已在人脸识别服务的管理控制台单击过“委托授权”： 如果已经授权，界面将显示为“已授权”。
x。 face_id String 人脸ID，由系统内部生成的唯一ID。 external_image_id String 人脸所在的外部图片ID。 external_fields Json 用户添加的额外字段。 父主题： 消息对象结构
计费说明 人脸识别接口调用次数 调用人脸识别的接口收费，提供按调用次数按需计费的方式。 计费模式 按需计费 按照API调用次数计费，按月累计，一个自然月后次数清零重新累计。 促销活动期间，每个用户每月前2000次免费（动作活体检测、静默活体检测不免费），具体计费价格请参见人脸识别价格详情。
能超过10000。 face_id 否，与offset二选一 String 人脸ID。 offset+limit值不能超过10000。人脸识别系统非存储系统，暂时不支持数据遍历操作，用户可以自行保存face_id，根据face_id查询导入的人脸信息。 请求参数 表3 请求Header参数
结构格式说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64字符串。 confidence Double 系统对检测对象是否为活体的判定置信程度，取值范围为0到1。置信度越高，表示系统越
计费说明 计费说明 到期与欠费
权限类 使用FRS服务需要的权限 FRS是否支持IAM细粒度划分 因权限造成的调用API失败
修订记录 发布日期 修改说明 2021-10-21 新版SDK正式发布，旧版SDK停止维护。
QPS限流时如何增加QPS配额 问题现象 调用人脸识别API时，报错“FRS.0033”。 该报错表示您当前请求数太多，超过流控限制。 解决方法 建议控制请求策略或者进行重试。 增加QPS配额。 请参考人脸识别价格详情，按照您的需求增加QPS配额。 变更QPS规格。 登录人脸识别管理控制台。 在左侧导航栏中选择“云上服务管理”。
统计API使用量 FRS控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包，可在“云上服务管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
错误码类 调用API报错时怎么处理 账密报错“The username or password is wrong.” 调用API操作APIG.0301怎么办 调用API报错FRS.0028怎么办 调用API报错FRS.0020怎么办 调用API报错"APIG.0101","API
如何调用API 申请服务 构造请求 认证鉴权 返回结果
公共数据结构 自定义字段 sort语法 filter语法 消息对象结构
状态码 表1 状态码 状态码 编码 说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如，切换到HTTP的新版本协议。 200
功能介绍 动作活体检测是通过判断视频中的人物动作与传入动作列表是否一致来识别视频中人物是否为活体，进行实人检测。如果有多张人脸出现，则选取最大的人脸进行判定。新老用户均可用该接口。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。 约束限制： 目前支持检测视频文件
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
