检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如需扩容单个人脸库规模，请联系华为云客服确认扩容规模。 默认并发：动作活体检测1QPS、其它接口10QPS。超出默认并发，会提示FRS.0033，当前请求太多，超出流控限制。
FRS全部系统权限请参见权限管理。 当现有策略不满足时，可使用FRS自定义策略。 子账户被赋予相应权限后，可使用子账户登录FRS控制台，开通所需的服务。 开通服务：主账号开通FRS的某个服务时，子账号未开通此服务，则子账号无法调用此服务，需子账号开通此服务后才可调用。
具体受限操作如下所示： 开通服务 购买按需套餐包 购买QPS套餐包 按需计费模式的API无法调用 为了避免影响业务正常使用，请您在收到欠费通知后，及时前往华为云控制台费用中心进行充值。
您可以根据以下方式的介绍选择合适的使用方式： 通过华为云API Explorer在线调用FRS服务API。 如果您是开发初学者，有代码编写基础，对HTTP请求与API调用有一定的了解，想快速体验FRS服务，该方式无需编码，只需要输入相关参数，即可调用API，体验服务应用效果。
系统不保存用户图片。 图片大小小于8MB，由于过大图片会导致时延较长，并且图片信息量不大，建议小于1MB。 图片分辨率小于4096*4096，图片中人脸像素大于80*80，建议120*120以上。
表3 请求Body参数 参数名 参数类型 是否必选 说明 image_url String 与image_file、image_base64、face_id四选一 图片的URL路径，目前仅支持华为云上OBS的URL，使用时只需保证FRS有权限读取该OBS桶的数据。
confidence Double 系统对检测对象是否为活体的判定置信程度，取值范围为0到1。置信度越高，表示系统越确定检测对象是一个真实的活体。可结合alive参数进行判断，alive返回true表示为活体。 父主题： 消息对象结构
置信度越高，表示系统越确定检测对象是一个真实的活体。可结合alive参数进行判断，alive返回true表示为活体。 父主题： 消息对象结构
face_id String 人脸ID，由系统内部生成的唯一ID。 external_image_id String 人脸所在的外部图片ID。 external_fields Json 用户添加的额外字段。 父主题： 消息对象结构
face_id String 人脸ID，由系统内部生成的唯一ID。 external_image_id String 人脸所在的外部图片ID。 similarity Double 人脸搜索时用于被检索的相似度。
系统不保存用户图片。 图片大小小于2MB，由于过大图片会导致时延较长，并且图片信息量不大，建议小于1MB。 图片分辨率小于4096*4096，图片中人脸像素大于40*40，建议120*120以上。
系统不保存用户图片。 图片大小小于8MB，由于过大图片会导致时延较长，并且图片信息量不大，建议小于1MB。 图片分辨率小于4096*4096，图片中人脸像素大于80*80，建议120*120以上。
系统不保存用户视频。 具体的约束限制信息请参见约束与限制章节。 建议： 建议帧率10fps～30fps。 视频文件的大小建议客户端压缩到200KB~2MB。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。
人脸识别系统非存储系统，暂时不支持数据遍历操作，用户可以自行保存face_id，根据face_id查询导入的人脸信息。 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。
Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。
表3 请求Body参数 参数名 参数类型 是否必选 说明 face_id String 是 人脸ID，由系统内部生成的唯一ID。 external_image_id String 否 用户指定的图片外部ID，与当前图像绑定。用户不设置该参数时，系统会自动生成一个。
如需扩容单个人脸库规模，请联系华为云客服确认扩容规模与价格。 表4 TypeInfo 参数 是否必选 参数类型 描述 type 否 String 数据类型支持string、integer、double、long等。
如何查看API的使用量 登录人脸识别管理控制台。 在左侧导航栏中选择“云上服务管理”，查看API的使用量。 父主题： API使用类
统计API使用量 FRS控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包，可在“云上服务管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
QPS限流时如何增加QPS配额 问题现象 调用人脸识别API时，报错“FRS.0033”。 该报错表示您当前请求数太多，超过流控限制。 解决方法 建议控制请求策略或者进行重试。 增加QPS配额。 请参考人脸识别价格详情，按照您的需求增加QPS配额。 变更QPS规格。 登录人脸识别管理控制台
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
