检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用服务 人脸识别提供了Web化的服务管理平台，即管理控制台，以及基于HTTPS请求的API管理方式。人脸识别以开放API的方式提供给用户，用户需要将人脸识别集成到第三方系统后才可使用。 用户需要先在管理控制台开通人脸识别服务，使用第三方系统调用API即可使用服务，具体流程如下：
如何查看API的使用量 登录人脸识别管理控制台。 在左侧导航栏中选择“云上服务管理”，查看API的使用量。 父主题： API使用类
人脸搜索接口中关于top_n参数如何设置 为什么使用人脸识别返回数据为空 人脸识别所需最低带宽是多少 如何获取OBS桶内最近图片的地址URL 人脸识别上传的人脸图片还可以查询到图片数据吗 人脸搜索是否需要使用OBS服务 如何查看API的使用量
使用流程简介 人脸识别通过实时访问和调用API获取人脸处理结果，帮助用户自动进行人脸的识别、比对以及相似度查询等。 使用流程 图1 使用流程 使用前必读 用户需要具备编程能力，熟悉Java、Python、iOS、Android、Node.js编程语言。 FRS服务需要用户通过调用
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
FRS服务使用简介 人脸识别服务（Face Recognition Service，简称FRS），是基于人的脸部特征信息，利用计算机对人脸图像进行处理、分析和理解，用户通过实时访问和调用API获取人脸处理结果，帮助用户自动进行人脸的识别、比对以及相似度查询等。 服务以开放API（Application
关于Token有效期的详细说明请参见获取IAM用户Token（使用密码）。使用Token前请确保Token离过期有足够的时间，防止调用API的过程中Token过期导致调用API失败。 重新获取Token，不影响已有Token有效性。如果在Token有效期内进行如下操作，当前Token将立即失效： 删除/停用IAM用户。
统计API使用量 FRS控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包，可在“云上服务管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
为什么使用人脸识别返回数据为空 问题现象 上传照片中的人像可能存在横置或倒置等情况。 解决方法 尽量选择纯色无干扰背景，保证图片中人像清晰。 上传的人脸图片要求：侧脸不超过30°，抬头低头不超过15°。 图片中人脸需要保持竖置正脸，如果人像是横置或倒置，可以选择旋转至竖置正脸后重试。
使用FRS服务需要的权限 使用FRS服务无需权限配置，在管理控制台开通服务后即可使用。 使用FRS服务时，如果您需要使用华为云对象存储服务（OBS）中的数据，请开通对象存储服务OBS授权，可在控制台进行开通。 FRS服务支持IAM细粒度划分策略。 父主题： 权限类
人脸搜索是否需要使用OBS服务 人脸搜索是否需要使用OBS服务 人脸搜索是指在已有的人脸库中，查询与目标人脸相似的一张或者多张人脸。在使用人脸搜索时，需创建人脸库（使用人脸库，也以开通人脸搜索服务为前提）。人脸库创建在华为云对象存储服务（OBS）中，您可以参考API文档“人脸库资
调用说明 人脸识别服务提供了RESTful API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题： 使用前必读
用户调用API接口时，需要使用Token进行鉴权。 本章节指导用户如何通过Postman获取用户Token。更多参数说明请参见获取IAM用户Token。 Token的有效期 关于Token有效期的详细说明请参见获取IAM用户Token（使用密码）。使用Token前请确保Token
如何获取正确的终端节点（Endpoint） 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同。 人脸识别服务的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点（Endpoint） 协议类型
REST客户端 Mozilla、Google都为REST提供了图形化的浏览器插件，发送处理请求消息。Postman建议使用7.24.0版本。 父主题： API使用类
注册服务时，没有将OBS权限授予FRS服务。 解决方案 图片的路径按照“/bucket/image-path”格式，不需要带上域名。 人脸服务只能访问当前账号的OBS桶。 账号需要将OBS权限授予人脸服务，人脸服务才能访问OBS上的图片。 父主题： API使用类
概述 欢迎使用人脸识别服务（Face Recognition Service，简称FRS），该服务能够在图像中快速检测人脸、分析人脸关键点信息、获取人脸属性、实现人脸的比对和检索。 人脸识别服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。 在调用人脸识别
重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和用户ID
系统承诺的QPS是在输入图片分辨率为640*480，200KB左右的图片大小时服务所能承受的规格，超过输入规格系统性能会有下降。如有疑问请及时咨询服务人员。 父主题： API使用类
只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可免费使用10个人脸库，每个人脸库容量为10万个人脸特征。如需扩容单个人脸库规模，请联系华为云客服确认扩容规模与价格。 application/json请求的body中，请使用标准Json格式。 Base64编码中请勿使用回车换行。 系统不保存用户图片或视频。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
