检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
.build(); endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 发送请求并查看响应 // 以调用人脸检测接口 DetectFaceByBase64 为例 const request = new frs.De
关闭服务 FRS服务开通后，如不使用，可登录控制台进行关闭。 如果您是主账户，也可以控制子用户的服务开通、关闭状态。 图1 关闭服务 图2 控制子用户的开通、关闭
->withEndpoint($endpoint) ->withCredentials($credentials) ->build(); 发送并查看响应 // 以调用人脸检测接口 DetectFaceByBase64 为例 $request = new DetectFaceByBase64Request();
申请服务 在调用API之前，必须先申请开通服务，下面是申请服务的相关步骤。 申请服务前，必须先注册云账号，并完成实名认证。 申请步骤 登录人脸识别管理控制台。 根据业务需求，选择服务部署区域，开通所需服务（例如：人脸检测），单击右侧的“开通服务”。 香港、曼谷区域API也可以使用
与其他云服务的关系 统一身份认证服务 人脸识别使用统一身份认证（Identity and Access Management，简称IAM）服务实现认证和鉴权功能。 对象存储服务 人脸识别支持从对象存储服务（Object Storage Service，简称OBS）读取人脸图片。 云审计服务
使用FRS服务，是否会保存用户数据 FRS服务坚持“华为云始终把可信作为产品质量的第一要素”的理念，我们基于安全、合规、隐私、韧性、透明，为您提供有技术、有未来、值得信赖的云服务。具体的声明请参考隐私政策声明和法律声明，可信资源请参见白皮书资源。关于人脸识别的相关声明请参见人脸识别服务声明。
0101、The username or password is wrong报错，请参见如何处理账密报错。 图5 Token认证鉴权 单击“Send”，发送请求，获取并复制Token。 获取返回结果“Headers”中的“X-Subject-Token”即为Token。 关于token有效期的
消息对象结构 AllParam DetectFace Landmark Attributes FaceQuality FaceExpression FaceSetFace SearchFace FaceSetInfo BoundingBox VideoDetectResult LivelessDetectResult
准备数据 数据要求 受技术与成本多种因素制约，FRS服务存在一些约束限制。 以人脸检测API为例，输入数据存在以下约束。其他API的的使用约束请参见API参考。 只支持识别JPG、PNG、JPEG、BMP格式的图片。 application/json请求的body中，请使用标准Json格式。
计费说明 计费说明 到期与欠费
API概览 人脸识别服务所提供的API，均符合RESTful API设计规范，如表1所示。 表1 人脸识别API 类型 API 说明 人脸检测 人脸检测 人脸检测是对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。 人脸比对 人脸比对 人脸比对是将两个人脸进行比
权限类 使用FRS服务需要的权限 FRS是否支持IAM细粒度划分 因权限造成的调用API失败
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见认证鉴权。 Content-Type 是 String 发送的实体的MIME类型，参数值为“application/json”。 Enterprise-Project-Id 否 String 企业项
AllUsers 为所有子用户订阅人脸搜索服务 √ × frs:faceSearch:unsubscribeAllUsers 为所有子用户取消订阅人脸搜索服务 √ × frs:faceCompare:subscribe 订阅人脸比对服务 √ × frs:faceCompare:unsubscribe
0101、The username or password is wrong报错，请参见如何处理账密报错。 图3 Token认证鉴权 单击“Send”，发送请求，获取并复制Token。 获取返回结果“Headers”中的“X-Subject-Token”即为Token。 关于token有效期的
脸识别服务接口产生扣费。 按需计费转为套餐包时，若套餐包还未生效，此时调用此服务，将按照按需计费模式计费。 用户调用额超出购买套餐配额。 用户购买QPS套餐包，超出并发后，调用按需接口。 用户购买服务套餐的区域与实际调用的区域不一致。 用户购买的服务与调用服务不一致。 父主题： 计费说明
需要输入相关参数，即可调用API，体验服务应用效果。使用前请参考申请服务开通所需要的API。 通过可视化工具（如curl、Postman）发送请求调用人脸识别服务API。 如果您是开发工程师，熟悉代码编写，熟悉HTTP请求与API调用，您可以通过postman调用、调试API。使用方法请参见调用API实现人脸检测。
调用API或SDK 在线调试 本地调用
人脸库资源管理 创建人脸库 查询所有人脸库 查询人脸库 删除人脸库 父主题： API
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
