检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
产品咨询类 如何在含有多张人脸的图片中实现多人脸识别 人脸识别是否可使用证件类照片 如何处理未经授权的情况 为什么会出现识别错误的情况 为什么人脸识别通过率低 为什么会请求响应过慢 人脸检测接口可以免费调多少次 如何关闭已申请的服务 调用静默活体检测API，为什么在服务管理页面看不到调用量
详情。 人脸库资源管理下的接口均免费，人脸资源管理下除添加人脸与删除人脸外均免费。 只有调用成功才会计算调用次数，未用完的免费调用次数不流转到下一个月。 计费规则：按调用次数计费，按月累计，一个自然月后调用次数清零重新累计。 每个用户可免费使用10个人脸库，每个人脸库容量为10万
调用说明 人脸识别服务提供了RESTful API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题： 使用前必读
本地调用 本章节以人脸检测为例，介绍如何使用FRS Python SDK在本地进行开发。 该接口可以对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。 前提条件 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。 已开通人脸检测。 操作步骤
使用该账户获取Token。 FRS.0020子服务未开通 在调用人脸识别接口时，报错“FRS.0020”，子服务未开通。该报错表示您的子服务没有开通，或url填写错误。 如未开通服务请登录人脸识别服务控制台人脸识别服务控制台选择“开通服务”。 如已经开通服务，请检查调用接口的请求地址是否正确。
未检测到人脸，无法搜索。 请参考约束与限制章节，上传符合规范的人脸图片。 400 FRS.0305 超过最大的人脸库数量，无法创建新的人脸库。 请检查人脸库数量是否超出限制联系客服提供支持。 403 FRS.0306 超过人脸库容量限制，无法增加更多的人脸。 请新增人脸库，重新添加人脸到新的人脸库中。
times 人脸识别 失败调用次数 该指标用于统计状态码为5xx的调用API失败的次数。 单位：次（times）。 ≥ 0 times 人脸识别 平均时延 该指标用于统计API的平均时延。 单位：毫秒（ms）。 ≥ 0 ms 人脸识别 人脸数量 该指标用于统计人脸库的人脸数量。 建
关闭服务 FRS服务开通后，如不使用，可登录控制台进行关闭。 如果您是主账户，也可以控制子用户的服务开通、关闭状态。 图1 关闭服务 图2 控制子用户的开通、关闭
为所有子用户取消订阅人脸比对服务 √ × frs:faceDetect:subscribe 订阅人脸检测服务 √ × frs:faceDetect:unsubscribe 取消订阅人脸检测服务 √ × frs:faceDetect:getSubscribeUserList 查询订阅人脸检测的用户列表
调用API或SDK 在线调试 本地调用
受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可免费使用10个人脸库，每个人脸库容量为10万个人脸特征。如需扩容
修订记录 发布日期 修改说明 2021-10-21 新版SDK正式发布，旧版SDK停止维护。
计费说明 计费说明 到期与欠费
权限类 使用FRS服务需要的权限 FRS是否支持IAM细粒度划分 因权限造成的调用API失败
在调用API之前，必须先申请开通服务，下面是申请服务的相关步骤。 申请服务前，必须先注册云账号，并完成实名认证。 申请步骤 登录人脸识别管理控制台。 根据业务需求，选择服务部署区域，开通所需服务（例如：人脸检测），单击右侧的“开通服务”。 香港、曼谷区域API也可以使用中国站账号进行开通；如您需要使用国际站
权限等信息，用户调用API接口时，需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。 下载地址：FRS-API.postman_collection.json。 导入配置文件。 打开并登录Postman。
构造请求 本节介绍REST API请求的组成，并以调用人脸检测为例说明如何调用API，您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。 请求URI 请求URI由如下部分组成。 {URI-scheme}
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
DetectFace 功能介绍 人脸检测以及人脸比对返回的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 landmark Landmark
统计API使用量 FRS控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包，可在“云上服务管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
