检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API 人脸检测 人脸比对 活体检测 人脸搜索 人脸库资源管理 人脸资源管理
权限管理 权限管理 创建用户组与IAM子用户 为子用户分配权限 用户登录并验证权限 FRS自定义策略
计费说明 人脸识别接口调用次数 调用人脸识别的接口收费,提供按调用次数按需计费的方式。 计费模式 按需计费 按照API调用次数计费,按月累计,一个自然月后次数清零重新累计。 促销活动期间,每个用户每月前2000次免费(动作活体检测、静默活体检测不免费),具体计费价格请参见人脸识别价格详情。
调用API或SDK 在线调试 本地调用
关闭服务 FRS服务开通后,如不使用,可登录控制台进行关闭。 如果您是主账户,也可以控制子用户的服务开通、关闭状态。 图1 关闭服务 图2 控制子用户的开通、关闭
计费说明 计费说明 到期与欠费
能超过10000。 face_id 否,与offset二选一 String 人脸ID。 offset+limit值不能超过10000。人脸识别系统非存储系统,暂时不支持数据遍历操作,用户可以自行保存face_id,根据face_id查询导入的人脸信息。 请求参数 表3 请求Header参数
功能介绍 动作活体检测是通过判断视频中的人物动作与传入动作列表是否一致来识别视频中人物是否为活体,进行实人检测。如果有多张人脸出现,则选取最大的人脸进行判定。新老用户均可用该接口。 前提条件: 请确保您已开通人脸识别服务,具体操作方法请参见申请服务。 约束限制: 目前支持检测视频文件
申请服务 在调用API之前,必须先申请开通服务,下面是申请服务的相关步骤。 申请服务前,必须先注册云账号,并完成实名认证。 申请步骤 登录人脸识别管理控制台。 根据业务需求,选择服务部署区域,开通所需服务(例如:人脸检测),单击右侧的“开通服务”。 香港、曼谷区域API也可以使用中国
状态码 表1 状态码 状态码 编码 说明 100 Continue 继续请求。 这个临时响应用来通知客户端,它的部分请求已经被服务器接收,且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如,切换到HTTP的新版本协议。 200
调用成功时无此字段。 请求示例 X-Auth-Token值获取方法请参见快速入门。 使用external_image_id(人脸所在的外部图片ID)删除人脸库中的某一人脸特征 DELETE https://{endpoint}/v2/{project_id}/face-sets/showFaceSet/faces
请求消息体 请求消息体通常以结构化格式发出,与请求消息头中Content-type对应,传递除请求消息头之外的内容。若请求消息体中参数支持中文,则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类
权限类 使用FRS服务需要的权限 FRS是否支持IAM细粒度划分 因权限造成的调用API失败
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
调用SDK实现人脸检测 人脸识别服务软件开发工具包(FRS SDK)是对人脸识别服务提供的REST API进行的封装,以简化用户的开发工作。 本章节以人脸检测API为例,介绍如何使用FRS Python SDK。 使用FRS SDK的详细步骤如下所示: 步骤1:开通服务 步骤2:安装SDK
为了避免影响业务正常使用,请您在收到欠费通知后,及时前往华为云控制台费用中心进行充值。 欠费案例 欠费原因常见于以下场景: 主账号未开通人脸识别服务,但由于子账号具备开通权限,子账号自行开通服务并调用人脸识别服务接口产生扣费。 按需计费转为套餐包时,若套餐包还未生效,此时调用此服务,将按照按需计费模式计费。 用户调用额超出购买套餐配额。
修订记录 发布日期 修改说明 2021-10-21 新版SDK正式发布,旧版SDK停止维护。
如何调用API 申请服务 构造请求 认证鉴权 返回结果
公共数据结构 自定义字段 sort语法 filter语法 消息对象结构
等信息,用户调用API接口时,需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。 下载地址:FRS-API.postman_collection.json。 导入配置文件。 打开并登录Postman。