检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
概述 欢迎使用人脸识别服务（Face Recognition Service，简称FRS），该服务能够在图像中快速检测人脸、分析人脸关键点信息、获取人脸属性、实现人脸的比对和检索。 人脸识别服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。
简介 人脸识别服务软件开发工具包（FRS SDK）是对人脸识别服务提供的REST API进行的封装，以简化用户的开发工作。FRS SDK目前支持Java、Python、Go、.NET、Node.js、PHP、C++版本。
API概览 人脸识别服务所提供的API，均符合RESTful API设计规范，如表1所示。 表1 人脸识别API 类型 API 说明 人脸检测 人脸检测 人脸检测是对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。
FRS服务需要用户通过调用API接口，识别图片中的人脸信息，然后返回JSON格式的识别结果，用户需要通过编码将识别结果对接到业务系统。 关于人脸识别的相关声明请参见人脸识别服务声明。 人脸识别服务等级协议请参见华为云服务等级协议。
≥ 0 ms 人脸识别 人脸数量 该指标用于统计人脸库的人脸数量。 建议人脸库的名称不要以下划线“_”开头，否则云监控服务会无法采集人脸数量。 单位：张（count）。 ≥ 0 count 人脸识别
开通服务 开通服务 登录人脸识别管理控制台。 根据业务需求，选择服务部署区域，开通所需服务（例如：人脸检测），单击右侧的“开通服务”。 图1 开通FRS服务 【可选】进行OBS委托授权。 调用API进行人脸的比对、检测时，可以从本地、obs、图片base64编码中读取数据。
图3 Windows环境新建环境变量 初始化客户端 指定region方式 // # 初始化人脸识别服务的客户端，并选择服务部署区域 func GetClient(auth basic.Credentials) *frs.FrsClient { client := frs.NewFrsClient
调用说明 人脸识别服务提供了RESTful API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题： 使用前必读
Python SDK 本章节介绍人脸识别服务Python SDK，您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。 已开通人脸识别服务。如未开通，请登录人脸识别管理控制台人脸识别管理控制台开通所需服务。
FRS.0020子服务未开通 在调用人脸识别接口时，报错“FRS.0020”，子服务未开通。该报错表示您的子服务没有开通，或url填写错误。 如未开通服务请登录人脸识别服务控制台人脸识别服务控制台选择“开通服务”。 如已经开通服务，请检查调用接口的请求地址是否正确。
调用人脸识别的接口收费，提供按QPS配额计费的方式，用户可以选择所需的QPS配额，具体计费价格请参见人脸识别价格详情。 系统承诺的QPS是在输入图片分辨率为640*480，200KB左右的图片大小时服务所能承受的规格，超过输入规格系统性能会有下降。如有疑问请及时咨询服务人员。
携带正确的ID，正常使用FRS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID，正常使用FRS服务，账单的企业项目会显示对应不存在的企业项目ID。
携带正确的ID，正常使用FRS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID，正常使用FRS服务，账单的企业项目会显示对应不存在的企业项目ID。
图3 Windows环境新建环境变量 初始化客户端 指定region方式 public static FrsClient getClient(Region region, ICredential auth) { // 初始化人脸识别服务的客户端 FrsClient
携带正确的ID，正常使用FRS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID，正常使用FRS服务，账单的企业项目会显示对应不存在的企业项目ID。
基于人脸识别、搜索技术，帮助客户精准营销。
约束与限制 受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。
FRS服务使用简介 人脸识别服务（Face Recognition Service，简称FRS），是基于人的脸部特征信息，利用计算机对人脸图像进行处理、分析和理解，用户通过实时访问和调用API获取人脸处理结果，帮助用户自动进行人脸的识别、比对以及相似度查询等。
超出默认并发，会提示FRS.0033，当前请求太多，超出流控限制。 套餐包 扣费时调用次数会先在套餐包内进行抵扣，抵扣完后的剩余调用量默认转回按需计费方式，具体计费价格请参见人脸识别价格详情。 这种购买方式相对于按需付费提供了更大的折扣，对于长期使用者，推荐该方式。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
