检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
调用SDK实现人脸检测 人脸识别服务软件开发工具包(FRS SDK)是对人脸识别服务提供的REST API进行的封装,以简化用户的开发工作。 本章节以人脸检测API为例,介绍如何使用FRS Python SDK。 使用FRS SDK的详细步骤如下所示: 步骤1:开通服务 步骤2:安装SDK
API 人脸检测 人脸比对 活体检测 人脸搜索 人脸库资源管理 人脸资源管理
结构格式说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64字符串。 confidence Double 系统对检测对象是否为活体的判定置信程度,取值范围为0到1。置信度越高,表示系统越
能超过10000。 face_id 否,与offset二选一 String 人脸ID。 offset+limit值不能超过10000。人脸识别系统非存储系统,暂时不支持数据遍历操作,用户可以自行保存face_id,根据face_id查询导入的人脸信息。 请求参数 表3 请求Header参数
因权限造成的调用API失败 问题现象 子用户已经开通了人脸识别服务,但是调用时还是提示未订阅。 解决方法 确认调用API所用的区域,与开通服务区域是否一致。 需要核实主账户赋予的权限,并核实开通服务的子账户与调用API时使用的子账户是否相同。 父主题: 权限类
为了避免影响业务正常使用,请您在收到欠费通知后,及时前往华为云控制台费用中心进行充值。 欠费案例 欠费原因常见于以下场景: 主账号未开通人脸识别服务,但由于子账号具备开通权限,子账号自行开通服务并调用人脸识别服务接口产生扣费。 按需计费转为套餐包时,若套餐包还未生效,此时调用此服务,将按照按需计费模式计费。 用户调用额超出购买套餐配额。
权限管理 权限管理 创建用户组与IAM子用户 为子用户分配权限 用户登录并验证权限 FRS自定义策略
状态码 表1 状态码 状态码 编码 说明 100 Continue 继续请求。 这个临时响应用来通知客户端,它的部分请求已经被服务器接收,且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如,切换到HTTP的新版本协议。 200
等信息,用户调用API接口时,需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。 下载地址:FRS-API.postman_collection.json。 导入配置文件。 打开并登录Postman。
关闭服务 FRS服务开通后,如不使用,可登录控制台进行关闭。 如果您是主账户,也可以控制子用户的服务开通、关闭状态。 图1 关闭服务 图2 控制子用户的开通、关闭
计费说明 计费说明 到期与欠费
如何处理未经授权的情况 提交OBS的数据到人脸识别服务进行识别,返回未经授权:The OBS is unauthorized时,您可以通过如下步骤处理: 使用OBS中的数据时,需要授权人脸识别服务能读取OBS数据,检查是否已在人脸识别服务的管理控制台单击过“委托授权”: 如果已经授权,界面将显示为“已授权”。
请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 人脸识别服务的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点(Endpoint) 协议类型 部署的服务 华北-北京四 cn-north-4
如何调用API 申请服务 构造请求 认证鉴权 返回结果
公共数据结构 自定义字段 sort语法 filter语法 消息对象结构
权限类 使用FRS服务需要的权限 FRS是否支持IAM细粒度划分 因权限造成的调用API失败
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
QPS限流时如何增加QPS配额 问题现象 调用人脸识别API时,报错“FRS.0033”。 该报错表示您当前请求数太多,超过流控限制。 解决方法 建议控制请求策略或者进行重试。 增加QPS配额。 请参考人脸识别价格详情,按照您的需求增加QPS配额。 变更QPS规格。 登录人脸识别管理控制台。 在左侧导航栏中选择“云上服务管理”。
0020怎么办 问题现象 在调用人脸识别接口时,报错“FRS.0020”,子服务未开通。 该报错表示您的子服务没有开通。 产生该报错的原因有以下两种: API没有开通,就直接调用,导致报错。 开通的API与实际调用的不一致,导致报错。 解决方法 如未开通服务请登录人脸识别服务控制台选择“开通服务”。
功能介绍 动作活体检测是通过判断视频中的人物动作与传入动作列表是否一致来识别视频中人物是否为活体,进行实人检测。如果有多张人脸出现,则选取最大的人脸进行判定。新老用户均可用该接口。 前提条件: 请确保您已开通人脸识别服务,具体操作方法请参见申请服务。 约束限制: 目前支持检测视频文件