错误码 调用API出错后,将不会返回结果数据。调用方可根据每个API对应的错误码来定位错误原因。当调用出错时,HTTP请求返回一个4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时,可以联系客服,并提供错误码,以便我们尽快帮您解决问题
人脸检测 功能介绍 人脸检测是对输入图片进行人脸检测和分析,输出人脸在图像中的位置、人脸关键属性。若照片中存在多张人脸,则返回所有符合条件的人脸特征信息。 前提条件: 请确保您已开通人脸识别服务,具体操作方法请参见申请服务。 约束限制: 只支持识别JPG、PNG、JPEG、BMP格式的图片
人脸比对 功能介绍 人脸比对是将两个人脸进行比对,来判断是否为同一个人,返回比对置信度。如果传入的图片中包含多个人脸,选取最大的人脸进行比对。 前提条件: 请确保您已开通人脸识别服务,具体操作方法请参见申请服务。 约束限制: 人脸比对输入的两张图片总大小。 只支持识别JPG、PNG
到期与欠费 保留期 包年包月资源包到期后,将自动转为按需计费。转按需后如果账号欠费,会根据“客户等级”定义不同的保留期时长,保留期内资源处理和费用详见“保留期”。保留期满仍未续订或充值,数据将被删除且无法恢复。 欠费说明 您的账号欠费后,会导致部分操作受限,建议您尽快续费。具体受限操作如下所示
统计API使用量 FRS控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包,可在“云上服务管理”页面,查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
计费说明 计费项 表1 计费项信息 计费项 计费说明 人脸识别接口调用次数 调用人脸识别的接口收费,提供按调用次数按需计费的方式。 计费模式 按需计费 按照API调用次数计费,按月累计,一个自然月后次数清零重新累计。 促销活动期间,每个用户每月前2000次免费(动作活体检测、静默活体检测不免费
调用说明 人脸识别服务提供了RESTful API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题: 使用前必读
高频报错处理办法 操作场景 本节内容介绍了调用API时,常见的报错及处理办法。 表1 调用API高频报错处理办法 常见报错 处理办法 FRS.0020子服务未开通 开通该服务,检查开通服务的区域(或账号)与调用服务的区域(或账号)是否一致,检查API的URL是否拼写正确。 APIG
权限管理 如果您需要对华为云上购买的FRS资源,为企业中的员工设置不同的访问权限,以达到不同员工之间的权限隔离,您可以使用统一身份认证服务(Identity and Access Management,简称IAM)进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功能
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 Token认证:通过Token认证通用请求。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。 Token认证 需要使用同一个Token鉴权时,可以缓存起来
sort语法 json array形式,排序只支持数值类型,字段重复定义会被覆盖。 例1:单个排序字段 "sort":[ { "location": "desc" } ] 例2:多个排序字段 "sort": [
调用API实现人脸检测 本章节提供了通过Postman调用FRS服务人脸检测API(V2)的样例,帮助您零编码快速体验并熟悉FRS服务的使用方法。 使用FRS服务API的详细步骤如下所示: 步骤1:开通服务 步骤2:配置环境 步骤3:Token认证鉴权 步骤4:调用服务 准备工作
获取Token Token是用户的访问令牌,承载了用户的身份、权限等信息,用户调用API接口时,需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。 下载地址:FRS-API.postman_collection.json
在线调试 API Explorer在线调试工具提供API的检索、调试、代码示例生成功能。同时,集成开发环境CloudIDE,可完成代码的构建、调试、运行。 本章节以人脸检测为例,介绍如何使用API Explorer调试API。 前提条件 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费
获取Token报错 获取Token时,请依据报错信息,选择相应的解决方案。 账密报错The username or password is wrong 返回The userInfo is wrong 请正确填写username和domainname,一般情况下,username=domainname
filter语法 数值类型 数值类型的范围查询,[]包含两端点值,{}不包含两端点值。 rowkey:[1 TO *] 大于等于1 rowkey:[* TO 1] 小于等于1 rowkey:[1 TO 10] 1到10 Request Body示例: {
约束与限制 受技术与成本多种因素制约,人脸识别服务存在一些约束限制。其中系统级约束限制,是所有子服务的约束。除系统级约束限制外,各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可免费使用10个人脸库,每个人脸库容量为10
本地调用 本章节以人脸检测为例,介绍如何使用FRS Python SDK在本地进行开发。 该接口可以对输入图片进行人脸检测和分析,输出人脸在图像中的位置、人脸关键属性。 前提条件 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费、冻结、被注销等异常状态。 已开通人脸检测。
调用SDK实现人脸检测 人脸识别服务软件开发工具包(FRS SDK)是对人脸识别服务提供的REST API进行的封装,以简化用户的开发工作。 本章节以人脸检测API为例,介绍如何使用FRS Python SDK。 使用FRS SDK的详细步骤如下所示: 步骤1:开通服务 步骤2:安装
删除人脸 功能介绍 根据指定字段删除人脸库中人脸,删除后人脸库容量会相应的释放。 前提条件: 请确保您已开通人脸搜索服务。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI
您即将访问非华为云网站,请注意账号财产安全