检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
本章节以人脸检测为例,介绍如何使用API Explorer调试API。 前提条件 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费、冻结、被注销等异常状态。 已开通人脸检测。 操作步骤 登录API Explorer。
区域与可用区 什么是区域和可用区域
数据安全类 使用FRS服务,是否会保存用户数据
统计API使用量 FRS控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包,可在“云上服务管理”页面,查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
错误码类 调用API报错时怎么处理 账密报错“The username or password is wrong.” 调用API操作APIG.0301怎么办 调用API报错FRS.0028怎么办 调用API报错FRS.0020怎么办 调用API报错"APIG.0101","API
DetectFace 功能介绍 人脸检测以及人脸比对返回的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。
face_id String 人脸ID,由系统内部生成的唯一ID。 external_image_id String 人脸所在的外部图片ID。 similarity Double 人脸搜索时用于被检索的相似度。
例如,下图报缺少frs:faceDetect:subscribe(开通人脸检测的权限)。 出现此类报错,子用户可联系主账户开通相应的服务。或者由主账户使用FRS自定义策略,帮助子用户开通权限后,子用户自行开通服务。 父主题: 权限管理
quality FaceQuality 图片中人脸的遮挡度、模糊度、光照强度、姿态角度。 expression FaceExpression 人脸表情,包括中性、高兴、害怕、惊讶、伤心、生气、厌恶。
FaceQuality 功能介绍 人脸质量结构。 参数说明 表1 结构格式说明表 名称 类型 说明 total_score Double 人脸质量总分,取值范围[0-1],分值越大质量越高。 blur Double 模糊度,取值范围[0-1],分值越大模糊问题越严重。
sort语法 json array形式,排序只支持数值类型,字段重复定义会被覆盖。 例1:单个排序字段 "sort":[ { "location": "desc" } ] 例2:多个排序字段 "sort": [
基本概念 账号 用户注册华为云时的账号,账号对其所拥有的资源及云服务具有完全的访问权限,可以重置用户密码、分配用户权限等。由于账号是付费主体,为了确保账号安全,建议您不要直接使用账号进行日常管理工作,而是创建用户并使用他们进行日常管理工作。 用户 由账号在IAM中创建的用户,是云服务的使用人员
BoundingBox 功能介绍 人脸在图像中的位置,坐标系的原点(0,0)在左上角。 参数说明 表1 结构格式说明表 名称 类型 说明 top_left_x Integer 矩形框左上角横坐标。 top_left_y Integer 矩形框左上角纵坐标。
FaceSetFace 功能介绍 人脸库当中的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。
调用API或SDK 在线调试 本地调用
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 Token认证:通过Token认证通用请求。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。 Token认证 需要使用同一个Token鉴权时,可以缓存起来
FaceExpression 功能介绍 人脸表情结构。
FaceSetInfo 功能介绍 人脸库的基本信息。 参数说明 表1 结构格式说明表 名称 类型 说明 face_set_name String 人脸库名称。 face_set_id String 人脸库ID,随机生成的包含八个字符的字符串。
FRS自定义策略 如果系统预置的权限,不满足您的授权要求,可以创建自定义策略。自定义策略中可以添加的授权项(Action)请参见权限管理。 目前华为云支持以下两种方式创建自定义策略: 可视化视图创建自定义策略:无需了解策略语法,按可视化视图导航栏选择云服务、操作、资源、条件等策略内容
用户登录并验证权限 使用新创建的IAM账户登录FRS控制台,切换至授权区域,进行验证权限。 进入FRS控制台界面,单击“开通服务”,如果无法开通,提示权限不足(假设主账户只为子用户开通了FRS ReadOnlyAccess只读权限),表示“FRS ReadOnlyAccess”已生效