检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
返回结果 请求发送以后,您会收到响应,包含:状态码、响应消息头和响应消息体。 状态码 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于获取用户Token接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头
申请服务 在调用API之前,必须先申请开通服务,下面是申请服务的相关步骤。 申请服务前,必须先注册云账号,并完成实名认证。 申请步骤 登录人脸识别管理控制台。 根据业务需求,选择服务部署区域,开通所需服务(例如:人脸检测),单击右侧的“开通服务”。 香港、曼谷区域API也可以使用中国站账号进行开通
构造请求 本节介绍REST API请求的组成,并以调用人脸检测为例说明如何调用API,您还可以通过这个视频教程了解如何构造请求调用API:https://bbs.huaweicloud.com/videos/102987。 请求URI 请求URI由如下部分组成。 {URI-scheme
C++ SDK 本章节介绍新版C++ SDK,您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费或冻结状态。 已具备开发环境,支持 C++ 14 及以上版本,要求安装 CMake 3.10 及以上版本。 登录“我的凭证 > 访问秘钥
sort语法 json array形式,排序只支持数值类型,字段重复定义会被覆盖。 例1:单个排序字段 "sort":[ { "location": "desc" } ] 例2:多个排序字段 "sort": [
约束与限制 受技术与成本多种因素制约,人脸识别服务存在一些约束限制。其中系统级约束限制,是所有子服务的约束。除系统级约束限制外,各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可免费使用10个人脸库,每个人脸库容量为10
基本概念 账号 用户注册华为云时的账号,账号对其所拥有的资源及云服务具有完全的访问权限,可以重置用户密码、分配用户权限等。由于账号是付费主体,为了确保账号安全,建议您不要直接使用账号进行日常管理工作,而是创建用户并使用他们进行日常管理工作。 用户 由账号在IAM中创建的用户,是云服务的使用人员
调用SDK实现人脸检测 人脸识别服务软件开发工具包(FRS SDK)是对人脸识别服务提供的REST API进行的封装,以简化用户的开发工作。 本章节以人脸检测API为例,介绍如何使用FRS Python SDK。 使用FRS SDK的详细步骤如下所示: 步骤1:开通服务 步骤2:安装
本地调用 本章节以人脸检测为例,介绍如何使用FRS Python SDK在本地进行开发。 该接口可以对输入图片进行人脸检测和分析,输出人脸在图像中的位置、人脸关键属性。 前提条件 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费、冻结、被注销等异常状态。 已开通人脸检测。
Node.js SDK 本章节介绍新版Node.js SDK,您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费或冻结状态。 已具备开发环境,支持Node 10.16.1 及其以上版本。 登录“我的凭证 > 访问秘钥”页面,获取
获取Token Token是用户的访问令牌,承载了用户的身份、权限等信息,用户调用API接口时,需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。 下载地址:FRS-API.postman_collection.json
调用API或SDK 在线调试 本地调用
与其他云服务的关系 统一身份认证服务 人脸识别使用统一身份认证(Identity and Access Management,简称IAM)服务实现认证和鉴权功能。 对象存储服务 人脸识别支持从对象存储服务(Object Storage Service,简称OBS)读取人脸图片。 云审计服务
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 Token认证:通过Token认证通用请求。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。 Token认证 需要使用同一个Token鉴权时,可以缓存起来
人脸库资源管理 创建人脸库 查询所有人脸库 查询人脸库 删除人脸库 父主题: API
为子用户分配权限 为子用户分配权限,子用户自行开通FRS服务 使用主账号登录IAM服务控制台。 打开用户组列表,找到子用户所在的用户组,单击该用户组的“授权”操作。 勾选需要授予用户组的权限,单击“确定”,完成用户组授权。FRS全部系统权限请参见权限管理。 当现有策略不满足时,可使用
终端节点 终端节点(Endpoint)即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 人脸识别服务的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点(Endpoint
FRS自定义策略 如果系统预置的权限,不满足您的授权要求,可以创建自定义策略。自定义策略中可以添加的授权项(Action)请参见权限管理。 目前华为云支持以下两种方式创建自定义策略: 可视化视图创建自定义策略:无需了解策略语法,按可视化视图导航栏选择云服务、操作、资源、条件等策略内容
用户登录并验证权限 使用新创建的IAM账户登录FRS控制台,切换至授权区域,进行验证权限。 进入FRS控制台界面,单击“开通服务”,如果无法开通,提示权限不足(假设主账户只为子用户开通了FRS ReadOnlyAccess只读权限),表示“FRS ReadOnlyAccess”已生效
filter语法 数值类型 数值类型的范围查询,[]包含两端点值,{}不包含两端点值。 rowkey:[1 TO *] 大于等于1 rowkey:[* TO 1] 小于等于1 rowkey:[1 TO 10] 1到10 Request Body示例: {