检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
Python SDK 本章节介绍人脸识别服务Python SDK，您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。 已开通人脸识别服务。如未开通，请登录人脸识别管理控制台人脸识别管理控制台开通所需服务。 已具备开发环境，支持Python3及以上版本。
约束与限制 受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可使用10个人脸库，每个人脸库容量为10万
FRS服务需要用户通过调用API接口，识别图片中的人脸信息，然后返回JSON格式的识别结果，用户需要通过编码将识别结果对接到业务系统。 关于人脸识别的相关声明请参见人脸识别服务声明。 人脸识别服务等级协议请参见华为云服务等级协议。
Java SDK 本章节介绍人脸识别服务Java SDK，您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。 已开通人脸识别服务。如未开通，请登录人脸识别管理控制台开通所需服务。 已具备开发环境，支持Java JDK
受技术与成本多种因素制约，FRS服务存在一些约束限制。 以人脸检测API为例，输入数据存在以下约束。其他API的的使用约束请参见API参考。 只支持识别JPG、PNG、JPEG、BMP格式的图片。 application/json请求的body中，请使用标准Json格式。 Base64编码中请勿使用回车换行。
人脸识别上传的人脸图片还可以查询到图片数据吗 人脸识别不存储客户人脸图片，只是根据客户的图片来检测人脸参数，只存储人脸特征。如果需要存储图片数据可参考以下方法： 可以开通华为云OBS，存储人脸图片。 人脸图片可以存储在客户自己的数据库中。 父主题： API使用类
由于请求的实体过大，服务器无法处理，因此拒绝请求。为防止客户端的连续请求，服务器可能会关闭连接。如果只是服务器暂时无法处理，则会包含一个Retry-After的响应信息。 414 Request-URI Too Large 请求的URI过长（URI通常为网址），服务器无法处理。 415 Unsupported
到的最大尺寸人脸作为检索的输入。 支持传入图片或者faceID进行人脸搜索。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。 约束限制： 只支持识别JPG、PNG、JPEG、BMP格式的图片。 application/json请求的body中，请使用标准Json格式。
计费说明 人脸识别接口调用次数 调用人脸识别的接口收费，提供按调用次数按需计费的方式。 计费模式 按需计费 按照API调用次数计费，按月累计，一个自然月后次数清零重新累计。 促销活动期间，每个用户每月前2000次免费（动作活体检测、静默活体检测不免费），具体计费价格请参见人脸识别价格详情。
单位：次（times）。 ≥ 0 times 人脸识别 失败调用次数 该指标用于统计状态码为5xx的调用API失败的次数。 单位：次（times）。 ≥ 0 times 人脸识别 平均时延 该指标用于统计API的平均时延。 单位：毫秒（ms）。 ≥ 0 ms 人脸识别 人脸数量 该指标用于统计人脸库的人脸数量。
信度。如果传入的图片中包含多个人脸，选取最大的人脸进行比对。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。 约束限制： 人脸比对输入的两张图片总大小。 只支持识别JPG、PNG、JPEG、BMP格式的图片。 application/json请求的body中，请使用标准Json格式。
用详见“保留期”。保留期满仍未续订或充值，数据将被删除且无法恢复。 欠费说明 您的账号欠费后，会导致部分操作受限，建议您尽快续费。具体受限操作如下所示： 开通服务 购买按需套餐包 购买QPS套餐包 按需计费模式的API无法调用 为了避免影响业务正常使用，请您在收到欠费通知后，及时前往华为云控制台费用中心进行充值。
调用说明 人脸识别服务提供了RESTful API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题： 使用前必读
证场景。 图1 身份验证 电子考勤 人脸检测及比对功能适用于客户企业对员工进行电子考勤。 客流分析 客流分析对于商场具有重要价值。基于人脸识别、搜索技术，帮助客户精准营销。
用该账户获取Token。 FRS.0020子服务未开通 在调用人脸识别接口时，报错“FRS.0020”，子服务未开通。该报错表示您的子服务没有开通，或url填写错误。 如未开通服务请登录人脸识别服务控制台人脸识别服务控制台选择“开通服务”。 如已经开通服务，请检查调用接口的请求地址是否正确。
权限类 使用FRS服务需要的权限 FRS是否支持IAM细粒度划分 因权限造成的调用API失败
API 人脸检测 人脸比对 活体检测 人脸搜索 人脸库资源管理 人脸资源管理
附录 状态码 错误码 获取项目ID/账号名/AK/SK
Programming Interface，应用程序编程接口）的方式提供人脸识别能力，用户调用API接口需要具备一定的编程开发能力，人脸识别后返回的结果为JSON格式，用户需要通过编程来处理识别结果。使用前，请登录人脸识别服务控制台开通服务。 您可以根据以下方式的介绍选择合适的使用方式： 通过华为云API
FRS.0304 未检测到人脸，无法搜索。 请参考约束与限制章节，上传符合规范的人脸图片。 400 FRS.0305 超过最大的人脸库数量，无法创建新的人脸库。 请检查人脸库数量是否超出限制联系客服提供支持。 403 FRS.0306 超过人脸库容量限制，无法增加更多的人脸。 请新增人脸库，重新添加人脸到新的人脸库中。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
