检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
简介 人脸识别服务软件开发工具包(FRS SDK)是对人脸识别服务提供的REST API进行的封装,以简化用户的开发工作。FRS SDK目前支持Java、Python、Go、.NET、Node.js、PHP、C++版本。
云服务之间的关系 如果多个云服务一起搭配使用,需要注意: 不同区域的弹性云服务器、关系型数据库、对象存储服务内网不互通。 不同区域的弹性云服务器不支持跨区域部署在同一负载均衡器下。 资源的价格 不同区域的资源价格可能有差异,请参见华为云服务价格详情。
IAM用户权限发生变化(如账号欠费无法访问云服务、申请公测通过、IAM用户权限被修改等)。 非华为云账号获取Token 如果您的华为云账号已升级为华为账号,将不支持获取账号Token,建议您为自己创建一个IAM用户,授予该用户必要的权限,获取IAM用户Token。
500 FRS.0018 服务内部错误。 请联系客服提供支持。 400 FRS.0019 服务未开通。 请登录人脸识别管理控制台,根据业务需求,选择需要开通的服务。 400 FRS.0020 子服务未开通。 请登录人脸识别管理控制台,根据业务需求,选择需要开通的子服务。
系统承诺的QPS是在输入图片分辨率为640*480,200KB左右的图片大小时服务所能承受的规格,超过输入规格系统性能会有下降。如有疑问请及时咨询服务人员。 父主题: API使用类
image_url String 图片的URL路径,目前仅支持华为云上OBS的URL,且人脸识别服务有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 image_file File 本地图片文件,图片不能超过8MB,建议小于1MB。
在华为云首页右上角,单击“控制台”。 在右上角的用户名中选择“我的凭证”。 在“我的凭证”界面,API凭证页签中,查看账号名、账号账号、用户名、用户ID、项目名称、项目ID。 父主题: 错误码类
请求方法 HTTP请求方法(也称为操作或动词),它告诉服务你正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。
request_id-timestamp-hostname(request_id在服务器端生成UUID, timestamp为当前时间戳,hostname为处理当前接口的服务器名称)。 默认值:无。 否 X-ratelimit 此字段携带总计流控请求数。 类型:整型。
调用说明 人脸识别服务提供了RESTful API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题: 使用前必读
签名SDK只提供签名功能,与服务提供的SDK不同,使用时请注意。 AK/SK获取方式请参考获取AK/SK。 父主题: 如何调用API
终端节点 终端节点(Endpoint)即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 人脸识别服务的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。
如果您购买了套餐包,可在“云上服务管理”页面,查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
图2 配置文件 本配置文件中服务所属区域为“华北-北京四”,如果您在开通服务时,选择了其他区域,在执行步骤3、步骤4时请将配置文件中的所有“cn-north-4”字段替换为实际区域,服务部署的区域具体请参见终端节点。
关闭服务:主账号关闭FRS的某个服务时,子账号未关闭此服务,则子账号依然可以调用此服务,并产生相应费用。如果需要暂停此服务,需要对应的子账号也关闭此服务。 不为子用户分配权限,主账户帮子用户开通FRS服务 使用主账号登录FRS服务控制台。
ServiceInfo 功能介绍 记录子服务信息。 参数说明 表1 结构格式说明表 名称 类型 说明 subscribe_status Boolean 是否开通该子服务。 create_time String 开通该子服务时间。 父主题: 消息对象结构
进入FRS控制台界面,单击“开通服务”,如果无法开通,提示权限不足(假设主账户只为子用户开通了FRS ReadOnlyAccess只读权限),表示“FRS ReadOnlyAccess”已生效。 父主题: 权限管理
获取Token报错 获取Token时,请依据报错信息,选择相应的解决方案。 账密报错The username or password is wrong 返回The userInfo is wrong 请正确填写username和domainname,一般情况下,username=domainname
创建用户组与IAM子用户 创建用户组 使用主账号登录IAM服务控制台。 左侧导航窗格中,选择“用户组”页签,单击右上方的“+创建用户组”。 在“创建用户组”界面,输入“用户组名称”,创建用户组。 返回用户组列表,单击列表中的“授权”。
sort语法 json array形式,排序只支持数值类型,字段重复定义会被覆盖。 例1:单个排序字段 "sort":[ { "location": "desc" } ] 例2:多个排序字段 "sort": [