检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
调用人脸识别的接口收费,提供按QPS配额计费的方式,用户可以选择所需的QPS配额,具体计费价格请参见人脸识别价格详情。 系统承诺的QPS是在输入图片分辨率为640*480,200KB左右的图片大小时服务所能承受的规格,超过输入规格系统性能会有下降。如有疑问请及时咨询服务人员。
准备数据 数据要求 受技术与成本多种因素制约,FRS服务存在一些约束限制。 以人脸检测API为例,输入数据存在以下约束。其他API的的使用约束请参见API参考。 只支持识别JPG、PNG、JPEG、BMP格式的图片。
关闭服务 FRS服务开通后,如不使用,可登录控制台进行关闭。 如果您是主账户,也可以控制子用户的服务开通、关闭状态。 图1 关闭服务 图2 控制子用户的开通、关闭
WarningList 功能介绍 视频活体检测警告信息。 参数说明 表1 结构格式说明 名称 类型 说明 warningCode Integer 警告ID。 warningMsg String 警告消息。 表2 错误提示 warningCode warningMsg 1 人脸没有朝向前方
FRS自定义策略 如果系统预置的权限,不满足您的授权要求,可以创建自定义策略。自定义策略中可以添加的授权项(Action)请参见权限管理。
": 1, "face_set_id": "T785tx1N", "face_set_name": "showFaceSet" } 状态码:400 失败响应样例 { "error_code": "FRS.0303", "error_msg": "The face id
调用说明 人脸识别服务提供了RESTful API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题: 使用前必读
FRS.0020子服务未开通 在调用人脸识别接口时,报错“FRS.0020”,子服务未开通。该报错表示您的子服务没有开通,或url填写错误。 如未开通服务请登录人脸识别服务控制台人脸识别服务控制台选择“开通服务”。 如已经开通服务,请检查调用接口的请求地址是否正确。
修订记录 发布日期 修改说明 2021-10-21 新版SDK正式发布,旧版SDK停止维护。
Python SDK 本章节介绍人脸识别服务Python SDK,您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费或冻结状态。 已开通人脸识别服务。如未开通,请登录人脸识别管理控制台人脸识别管理控制台开通所需服务。
图3 Windows环境新建环境变量 初始化客户端 指定region方式 // # 初始化人脸识别服务的客户端,并选择服务部署区域 func GetClient(auth basic.Credentials) *frs.FrsClient { client := frs.NewFrsClient
人脸资源管理 添加人脸 查询人脸 更新人脸 删除人脸 批量删除人脸 父主题: API
图3 Windows环境新建环境变量 初始化客户端 指定region方式 public static FrsClient getClient(Region region, ICredential auth) { // 初始化人脸识别服务的客户端 FrsClient
400 FRS.0402 输入的字段不存在。 请参考人脸资源管理接口说明。 400 FRS.0403 Face ID不存在。 请检查输入的Face ID是否存在。 400 FRS.0404 未检测到人脸,无法添加。 请参考约束与限制章节,上传符合规范的人脸图片。
计费说明 计费说明 到期与欠费
权限类 使用FRS服务需要的权限 FRS是否支持IAM细粒度划分 因权限造成的调用API失败
≥ 0 ms 人脸识别 人脸数量 该指标用于统计人脸库的人脸数量。 建议人脸库的名称不要以下划线“_”开头,否则云监控服务会无法采集人脸数量。 单位:张(count)。 ≥ 0 count 人脸识别
超出默认并发,会提示FRS.0033,当前请求太多,超出流控限制。 套餐包 扣费时调用次数会先在套餐包内进行抵扣,抵扣完后的剩余调用量默认转回按需计费方式,具体计费价格请参见人脸识别价格详情。 这种购买方式相对于按需付费提供了更大的折扣,对于长期使用者,推荐该方式。
// 终端节点以 FRS 服务北京四的 endpoint 为例 $ak = getenv('HUAWEICLOUD_SDK_AK'); $sk = getenv('HUAWEICLOUD_SDK_SK'); $endpoint = "https://face.cn-north-4
统计API使用量 FRS控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包,可在“云上服务管理”页面,查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。