检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何调用API 申请服务 构造请求 认证鉴权 返回结果
公共数据结构 自定义字段 sort语法 filter语法 消息对象结构
人脸资源管理 添加人脸 查询人脸 更新人脸 删除人脸 批量删除人脸 父主题： API
约束与限制 受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可使用10个人脸库，每个人脸库容量为10万
错误码 调用API出错后，将不会返回结果数据。调用方可根据每个API对应的错误码来定位错误原因。当调用出错时，HTTP请求返回一个4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系客服，并提供错误码，以便我们尽快帮您解决问题。
image_url String 与image_file、image_base64、face_id四选一 图片的URL路径，目前仅支持华为云上OBS的URL，使用时只需保证FRS有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 image_file File 与im
应用场景 身份验证 使用人脸检测与比对功能，可进行身份核实，适用于机场、海关等人证合一验证场景。 图1 身份验证 电子考勤 人脸检测及比对功能适用于客户企业对员工进行电子考勤。 客流分析 客流分析对于商场具有重要价值。基于人脸识别、搜索技术，帮助客户精准营销。
计费说明 计费项 表1 计费项信息 计费项 计费说明 人脸识别接口调用次数 调用人脸识别的接口收费，提供按调用次数按需计费的方式。 计费模式 按需计费 按照API调用次数计费，按月累计，一个自然月后次数清零重新累计。 促销活动期间，每个用户每月前2000次免费（动作活体检测、静默
QPS是什么 QPS（Queries Per Second）即每秒钟的请求量。调用人脸识别的接口收费，提供按QPS配额计费的方式，用户可以选择所需的QPS配额，具体计费价格请参见人脸识别价格详情。 系统承诺的QPS是在输入图片分辨率为640*480，200KB左右的图片大小时服务
本样例以“华北-北京四”区域为例，获取对应的项目ID（project_id）。 图2 我的凭证 安装SDK 使用SDK前需要安装华为云Go SDK 库。 # 安装华为云Go库 go get -u github.com/huaweicloud/huaweicloud-sdk-go-v3 # 安装依赖
统计API使用量 FRS控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包，可在“云上服务管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
开通服务 购买按需套餐包 购买QPS套餐包 按需计费模式的API无法调用 为了避免影响业务正常使用，请您在收到欠费通知后，及时前往华为云控制台费用中心进行充值。 欠费案例 欠费原因常见于以下场景： 主账号未开通人脸识别服务，但由于子账号具备开通权限，子账号自行开通服务并调用人脸识别服务接口产生扣费。
调用说明 人脸识别服务提供了RESTful API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题： 使用前必读
获取Token时出现“The username or password is wrong.”。 请确认近期华为云账号是否有升级为华为账号。当前，如果您通过华为账号入口登录华为云账号，就会指引升级。华为云账号若已升级为华为账号，将不支持获取账号Token。 建议您创建一个IAM账户，使用该账户获取Token。
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 Token认证：通过Token认证通用请求。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key)加密调用请求。 Token认证 需要使用同一个Token鉴权时，可以缓存起来，避免频繁调用。
获取Token Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。 下载地址：FRS-API.postman_collection
sort语法 json array形式，排序只支持数值类型，字段重复定义会被覆盖。 例1：单个排序字段 "sort":[ { "location": "desc" } ] 例2：多个排序字段 "sort": [
约束与限制 受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可免费使用10个人脸库，每个人脸库容量为1
可完成代码的构建、调试、运行。 本章节以人脸检测为例，介绍如何使用API Explorer调试API。 前提条件 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。 已开通人脸检测。 操作步骤 登录API Explorer。 登录后，“X-Au
为子用户分配权限 为子用户分配权限，子用户自行开通FRS服务 使用主账号登录IAM服务控制台。 打开用户组列表，找到子用户所在的用户组，单击该用户组的“授权”操作。 勾选需要授予用户组的权限，单击“确定”，完成用户组授权。FRS全部系统权限请参见权限管理。 当现有策略不满足时，可使用FRS自定义策略。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
