检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
附录 状态码 错误码 获取项目ID/账号名/AK/SK
有哪些途径可以使用人脸识别的API 共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，并接收响应消息。cURL适用于接口调试。 编码 通过编码调用接口，组装请求消息，并发送处理请求消息。
权限管理 权限管理 创建用户组与IAM子用户 为子用户分配权限 用户登录并验证权限 FRS自定义策略
约束与限制 受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可使用10个人脸库，每个人脸库容量为10万
应用场景 身份验证 使用人脸检测与比对功能，可进行身份核实，适用于机场、海关等人证合一验证场景。 图1 身份验证 电子考勤 人脸检测及比对功能适用于客户企业对员工进行电子考勤。 客流分析 客流分析对于商场具有重要价值。基于人脸识别、搜索技术，帮助客户精准营销。
人脸识别上传的人脸图片还可以查询到图片数据吗 人脸识别不存储客户人脸图片，只是根据客户的图片来检测人脸参数，只存储人脸特征。如果需要存储图片数据可参考以下方法： 可以开通华为云OBS，存储人脸图片。 人脸图片可以存储在客户自己的数据库中。 父主题： API使用类
FRS服务需要用户通过调用API接口，识别图片中的人脸信息，然后返回JSON格式的识别结果，用户需要通过编码将识别结果对接到业务系统。 关于人脸识别的相关声明请参见人脸识别服务声明。 人脸识别服务等级协议请参见华为云服务等级协议。
API概览 人脸识别服务所提供的API，均符合RESTful API设计规范，如表1所示。 表1 人脸识别API 类型 API 说明 人脸检测 人脸检测 人脸检测是对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。 人脸比对 人脸比对 人脸比对是将两个人脸进行比
成功响应样例 { "face_number": 1, "face_set_id": "T785tx1N", "face_set_name": "showFaceSet" } 状态码：400 失败响应样例 { "error_code": "FRS.0303", "error_msg":
开通服务 开通服务 登录人脸识别管理控制台。 根据业务需求，选择服务部署区域，开通所需服务（例如：人脸检测），单击右侧的“开通服务”。 图1 开通FRS服务 【可选】进行OBS委托授权。 调用API进行人脸的比对、检测时，可以从本地、obs、图片base64编码中读取数据。仅当您
调用API实现人脸检测 本章节提供了通过Postman调用FRS服务人脸检测API（V2）的样例，帮助您零编码快速体验并熟悉FRS服务的使用方法。 使用FRS服务API的详细步骤如下所示： 步骤1：开通服务 步骤2：配置环境 步骤3：Token认证鉴权 步骤4：调用服务 准备工作
准备数据 数据要求 受技术与成本多种因素制约，FRS服务存在一些约束限制。 以人脸检测API为例，输入数据存在以下约束。其他API的的使用约束请参见API参考。 只支持识别JPG、PNG、JPEG、BMP格式的图片。 application/json请求的body中，请使用标准Json格式。
如何获取正确的终端节点（Endpoint） 如何获取图片的base64编码 人脸搜索接口中关于top_n参数如何设置 为什么使用人脸识别返回数据为空 人脸识别所需最低带宽是多少 如何获取OBS桶内最近图片的地址URL 人脸识别上传的人脸图片还可以查询到图片数据吗 人脸搜索是否需要使用OBS服务 如何查看API的使用量
QPS是什么 QPS（Queries Per Second）即每秒钟的请求量。调用人脸识别的接口收费，提供按QPS配额计费的方式，用户可以选择所需的QPS配额，具体计费价格请参见人脸识别价格详情。 系统承诺的QPS是在输入图片分辨率为640*480，200KB左右的图片大小时服务
建一个IAM账户，使用该账户获取Token。 FRS.0020子服务未开通 在调用人脸识别接口时，报错“FRS.0020”，子服务未开通。该报错表示您的子服务没有开通，或url填写错误。 如未开通服务请登录人脸识别服务控制台人脸识别服务控制台选择“开通服务”。 如已经开通服务，请检查调用接口的请求地址是否正确。
因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 404 NotFound 所请求的资源不存在。 建议直接修改该请求，不要重试该请求。 405 MethodNotAllowed 请求中带有该资源不支持的方法。 建议直接修改该请求，不要重试该请求。 406 Not
调用SDK实现人脸检测 人脸识别服务软件开发工具包（FRS SDK）是对人脸识别服务提供的REST API进行的封装，以简化用户的开发工作。 本章节以人脸检测API为例，介绍如何使用FRS Python SDK。 使用FRS SDK的详细步骤如下所示： 步骤1：开通服务 步骤2：安装SDK
（错误码区间：401～500） 400 FRS.0401 找不到对应类型的值，无法删除。 请参考人脸资源管理接口说明。 400 FRS.0402 输入的字段不存在。 请参考人脸资源管理接口说明。 400 FRS.0403 Face ID不存在。 请检查输入的Face ID是否存在。 400 FRS.0404 未检测到人脸，无法添加。
修订记录 发布日期 修改说明 2021-10-21 新版SDK正式发布，旧版SDK停止维护。
调用说明 人脸识别服务提供了RESTful API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题： 使用前必读
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
