检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
修订记录 发布日期 修改说明 2021-10-21 新版SDK正式发布,旧版SDK停止维护。
促销活动期间,每个用户每月前2000次免费(动作活体检测、静默活体检测不免费),具体计费价格请参见人脸识别价格详情。 人脸库资源管理下的接口均免费,人脸资源管理下除添加人脸与删除人脸外均免费。 只有调用成功才会计算调用次数,未用完的免费调用次数不流转到下一个月。
调用说明 人脸识别服务提供了RESTful API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题: 使用前必读
var req = new DeleteFaceByFaceIdRequest { FaceSetName = "人脸库名称", FaceId = "人脸ID" };
FRS.0020子服务未开通 在调用人脸识别接口时,报错“FRS.0020”,子服务未开通。该报错表示您的子服务没有开通,或url填写错误。 如未开通服务请登录人脸识别服务控制台人脸识别服务控制台选择“开通服务”。 如已经开通服务,请检查调用接口的请求地址是否正确。
申请步骤 登录人脸识别管理控制台。 根据业务需求,选择服务部署区域,开通所需服务(例如:人脸检测),单击右侧的“开通服务”。 香港、曼谷区域API也可以使用中国站账号进行开通;如您需要使用国际站账号开通香港、曼谷区域API,请联系客服获取开通支持。
图2 我的凭证 安装SDK 在Linux系统上安装SDK 获取依赖包 所需的这些第三方软件包在大部分系统的包管理工具中都有提供,例如基于 Debian/Ubuntu 的系统。
例如,对于人脸检测接口,您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示。
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
每个用户可免费使用10个人脸库,每个人脸库容量为10万个人脸特征。如需扩容单个人脸库规模,请联系华为云客服确认扩容规模与价格。 application/json请求的body中,请使用标准Json格式。 Base64编码中请勿使用回车换行。 系统不保存用户图片或视频。
下载人脸识别服务Postman配置文件。 下载地址:FRS-API.postman_collection.json。 导入配置文件。 打开并登录Postman。 单击左上角“File > Import > Import File > Choose Files”导入配置文件。
本章节以人脸检测为例,介绍如何使用API Explorer调试API。 前提条件 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费、冻结、被注销等异常状态。 已开通人脸检测。 操作步骤 登录API Explorer。
const request = new frs.UpdateFaceRequest(); request.faceSetName = "人脸库名称"; const body = new frs.UpdateFaceReq(); body.withFaceId("人脸库ID");
欠费案例 欠费原因常见于以下场景: 主账号未开通人脸识别服务,但由于子账号具备开通权限,子账号自行开通服务并调用人脸识别服务接口产生扣费。 按需计费转为套餐包时,若套餐包还未生效,此时调用此服务,将按照按需计费模式计费。 用户调用额超出购买套餐配额。
对于人脸检测接口,返回如下消息体。
活体检测 动作活体检测 静默活体检测 父主题: API
区域与可用区 什么是区域和可用区域
数据安全类 使用FRS服务,是否会保存用户数据
统计API使用量 FRS控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包,可在“云上服务管理”页面,查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
错误码类 调用API报错时怎么处理 账密报错“The username or password is wrong.” 调用API操作APIG.0301怎么办 调用API报错FRS.0028怎么办 调用API报错FRS.0020怎么办 调用API报错"APIG.0101","API