检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
本地调用 本章节以人脸检测为例,介绍如何使用FRS Python SDK在本地进行开发。 该接口可以对输入图片进行人脸检测和分析,输出人脸在图像中的位置、人脸关键属性。 前提条件 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费、冻结、被注销等异常状态。 已开通人脸检测。
在线调试 API Explorer在线调试工具提供API的检索、调试、代码示例生成功能。同时,集成开发环境CloudIDE,可完成代码的构建、调试、运行。 本章节以人脸检测为例,介绍如何使用API Explorer调试API。 前提条件 注册华为账号并开通华为云,并完成实名认证,
为子用户分配权限 为子用户分配权限,子用户自行开通FRS服务 使用主账号登录IAM服务控制台。 打开用户组列表,找到子用户所在的用户组,单击该用户组的“授权”操作。 勾选需要授予用户组的权限,单击“确定”,完成用户组授权。FRS全部系统权限请参见权限管理。 当现有策略不满足时,可使用FRS自定义策略。
终端节点 终端节点(Endpoint)即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 人脸识别服务的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点(Endpoint)
为什么会请求响应过慢 问题现象 用户发送https请求,需要经过tcp握手以及https证书交换,这个过程如果出现丢包情况,操作系统会进行数据包重传,重传间隔根据系统不同可能会3s或者5s。 解决方案 使用https长连接的方式进行请求,这样不必要每次请求都进行http建连。考虑
自定义字段 数据类型 支持String,Integer,Float,Double,Boolean,Long。 external_image_id,bounding_box,similarity,face_id,create_time,vector,_id,_all,_source为内置字段,自定义字段避免使用。
DetectFace 功能介绍 人脸检测以及人脸比对返回的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 landmark Landmark
SearchFace 功能介绍 人脸搜索返回的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸ID,由系统内部生成的唯一ID。
BoundingBox 功能介绍 人脸在图像中的位置,坐标系的原点(0,0)在左上角。 参数说明 表1 结构格式说明表 名称 类型 说明 top_left_x Integer 矩形框左上角横坐标。 top_left_y Integer 矩形框左上角纵坐标。 width Integer
FaceQuality 功能介绍 人脸质量结构。 参数说明 表1 结构格式说明表 名称 类型 说明 total_score Double 人脸质量总分,取值范围[0-1],分值越大质量越高。 blur Double 模糊度,取值范围[0-1],分值越大模糊问题越严重。 pose Double
因权限造成的调用API失败 问题现象 子用户已经开通了人脸识别服务,但是调用时还是提示未订阅。 解决方法 确认调用API所用的区域,与开通服务区域是否一致。 需要核实主账户赋予的权限,并核实开通服务的子账户与调用API时使用的子账户是否相同。 父主题: 权限类
FaceSetInfo 功能介绍 人脸库的基本信息。 参数说明 表1 结构格式说明表 名称 类型 说明 face_set_name String 人脸库名称。 face_set_id String 人脸库ID,随机生成的包含八个字符的字符串。 create_date String
FaceExpression 功能介绍 人脸表情结构。 参数说明 表1 结构格式说明表 名称 类型 说明 type String 人脸表情类型 neutral:中性 happy:高兴 fear:害怕 surprise:惊讶 sad:伤心 angry:生气 disgust:厌恶 unknown:图片质量问题导致未识别
Landmark 功能介绍 人脸关键点结构。 参数说明 表1 结构格式说明表 名称 类型 说明 nose_contour List [Point] 鼻子轮廓,Point为轮廓坐标值。 mouth_contour List [Point] 嘴巴轮廓,Point为轮廓坐标值。 eyebrow_contour
如何处理未经授权的情况 提交OBS的数据到人脸识别服务进行识别,返回未经授权:The OBS is unauthorized时,您可以通过如下步骤处理: 使用OBS中的数据时,需要授权人脸识别服务能读取OBS数据,检查是否已在人脸识别服务的管理控制台单击过“委托授权”: 如果已经授权,界面将显示为“已授权”。
如何查看API的使用量 登录人脸识别管理控制台。 在左侧导航栏中选择“云上服务管理”,查看API的使用量。 父主题: API使用类
ServiceInfo 功能介绍 记录子服务信息。 参数说明 表1 结构格式说明表 名称 类型 说明 subscribe_status Boolean 是否开通该子服务。 create_time String 开通该子服务时间。 父主题: 消息对象结构
创建用户组与IAM子用户 创建用户组 使用主账号登录IAM服务控制台。 左侧导航窗格中,选择“用户组”页签,单击右上方的“+创建用户组”。 在“创建用户组”界面,输入“用户组名称”,创建用户组。 返回用户组列表,单击列表中的“授权”。 勾选需要授予用户组的权限,单击“确定”,完成用户组授权。
FaceSetFace 功能介绍 人脸库当中的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸ID,由系统内部生成的唯一ID。
获取AK/SK 登录人脸识别管理控制台。 单击页面右上角的用户名,并选择“我的凭证”。 进入“我的凭证”页面。 单击“访问秘钥”页签下的“新增访问密钥”。 弹出“新增访问密钥”对话框。 输入“登录密码”,如果绑定了手机或者邮箱,还需要获取验证码并进行验证。 验证成功后,弹出访问密钥下载对话框。