检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
约束与限制 受技术与成本多种因素制约,人脸识别服务存在一些约束限制。其中系统级约束限制,是所有子服务的约束。除系统级约束限制外,各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可免费使用10个人脸库,每个人脸库容量为10
基本概念 账号 用户注册华为云时的账号,账号对其所拥有的资源及云服务具有完全的访问权限,可以重置用户密码、分配用户权限等。由于账号是付费主体,为了确保账号安全,建议您不要直接使用账号进行日常管理工作,而是创建用户并使用他们进行日常管理工作。 用户 由账号在IAM中创建的用户,是云服务的使用人员
本地调用 本章节以人脸检测为例,介绍如何使用FRS Python SDK在本地进行开发。 该接口可以对输入图片进行人脸检测和分析,输出人脸在图像中的位置、人脸关键属性。 前提条件 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费、冻结、被注销等异常状态。 已开通人脸检测。
获取Token Token是用户的访问令牌,承载了用户的身份、权限等信息,用户调用API接口时,需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。 下载地址:FRS-API.postman_collection.json
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示例: {
到期与欠费 保留期 包年包月资源包到期后,将自动转为按需计费。转按需后如果账号欠费,会根据“客户等级”定义不同的保留期时长,保留期内资源处理和费用详见“保留期”。保留期满仍未续订或充值,数据将被删除且无法恢复。 欠费说明 您的账号欠费后,会导致部分操作受限,建议您尽快续费。具体受限操作如下所示
返回结果 请求发送以后,您会收到响应,包含:状态码、响应消息头和响应消息体。 状态码 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于获取用户Token接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头
申请服务 在调用API之前,必须先申请开通服务,下面是申请服务的相关步骤。 申请服务前,必须先注册云账号,并完成实名认证。 申请步骤 登录人脸识别管理控制台。 根据业务需求,选择服务部署区域,开通所需服务(例如:人脸检测),单击右侧的“开通服务”。 香港、曼谷区域API也可以使用中国站账号进行开通
构造请求 本节介绍REST API请求的组成,并以调用人脸检测为例说明如何调用API,您还可以通过这个视频教程了解如何构造请求调用API:https://bbs.huaweicloud.com/videos/102987。 请求URI 请求URI由如下部分组成。 {URI-scheme
为子用户分配权限 为子用户分配权限,子用户自行开通FRS服务 使用主账号登录IAM服务控制台。 打开用户组列表,找到子用户所在的用户组,单击该用户组的“授权”操作。 勾选需要授予用户组的权限,单击“确定”,完成用户组授权。FRS全部系统权限请参见权限管理。 当现有策略不满足时,可使用
与其他云服务的关系 统一身份认证服务 人脸识别使用统一身份认证(Identity and Access Management,简称IAM)服务实现认证和鉴权功能。 对象存储服务 人脸识别支持从对象存储服务(Object Storage Service,简称OBS)读取人脸图片。 云审计服务
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 Token认证:通过Token认证通用请求。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。 Token认证 需要使用同一个Token鉴权时,可以缓存起来
使用FRS服务需要的权限 使用FRS服务无需权限配置,在管理控制台开通服务后即可使用。 使用FRS服务时,如果您需要使用华为云对象存储服务(OBS)中的数据,请开通对象存储服务OBS授权,可在控制台进行开通。 FRS服务支持IAM细粒度划分策略。 父主题: 权限类
Landmark 功能介绍 人脸关键点结构。 参数说明 表1 结构格式说明表 名称 类型 说明 nose_contour List [Point] 鼻子轮廓,Point为轮廓坐标值。 mouth_contour List [Point] 嘴巴轮廓,Point为轮廓坐标值。 eyebrow_contour
为什么会请求响应过慢 问题现象 用户发送https请求,需要经过tcp握手以及https证书交换,这个过程如果出现丢包情况,操作系统会进行数据包重传,重传间隔根据系统不同可能会3s或者5s。 解决方案 使用https长连接的方式进行请求,这样不必要每次请求都进行http建连。考虑到
Attributes 功能介绍 人脸属性结构。 参数说明 表1 结构格式说明表 名称 类型 说明 age Integer 年龄。 dress List of strings 包含glass和hat两个属性结果。 glass String 是否戴眼镜: yes:戴眼镜 none:未戴眼镜
自定义字段 数据类型 支持String,Integer,Float,Double,Boolean,Long。 external_image_id,bounding_box,similarity,face_id,create_time,vector,_id,_all,_source为内置字段
AllParam 功能介绍 涉及到的所有参数类型的详细说明。 参数说明 表1 结果格式说明表 名称 类型 说明 project_id String 项目ID,获取方法请参见获取项目ID/账号名/AK/SK。 image_url String 图片的URL路径,目前仅支持华为云上OBS