# 人脸识别服务 FRS

> 用于身份验证、电子考勤、客流分析等场景

## 产品介绍

- [什么是人脸识别](https://support.huaweicloud.com/productdesc-face/face_01_0001.md): 人脸识别服务（Face Recognition Service，简称FRS），是基于人的脸部特征信息，利用计算机对人脸图像进行处理、分析和理解，进行身份识别的一种智能服务。人脸识别以开放API（Application Programming Interface，应用程序编程接口）的方式提供给用户，用户通过实时访问和调用API获取人脸处理结
- [应用场景](https://support.huaweicloud.com/productdesc-face/face_01_0002.md): 使用人脸检测与比对功能，可进行身份核实，适用于机场、海关等人证合一验证场景。人脸检测及比对功能适用于客户企业对员工进行电子考勤。客流分析对于商场具有重要价值。基于人脸识别、搜索技术，帮助客户精准营销。
- [计费说明](https://support.huaweicloud.com/productdesc-face/face_01_0016.md): 按需计费按照API调用次数计费，按月累计，一个自然月后次数清零重新累计。每个用户每月前2000次调用免费（动作活体检测不免费），具体计费价格请参见人脸识别价格详情。人脸库资源管理下的接口均免费，人脸资源管理下除添加人脸与删除人脸外均免费。只有调用成功才会计算调用次数，未用完的免费调用次数不流转到下一个月。计费规则：按调用次数计费，按月累计
- [到期与欠费](https://support.huaweicloud.com/productdesc-face/face_01_0017.md): 包年包月资源包到期后，将自动转为按需计费。转按需后如果账号欠费，会根据“客户等级”定义不同的保留期时长，保留期内资源处理和费用详见“保留期”。保留期满仍未续订或充值，数据将被删除且无法恢复。您的账号欠费后，会导致部分操作受限，建议您尽快续费。具体受限操作如下所示：开通服务购买按需套餐包购买QPS套餐包按需计费模式的API无法调用为了避免影
- [与其他云服务的关系](https://support.huaweicloud.com/productdesc-face/face_01_0008.md): 人脸识别使用统一身份认证（Identity and Access Management，简称IAM）服务实现认证和鉴权功能。人脸识别支持从对象存储服务（Object Storage Service，简称OBS）读取人脸图片。人脸识别使用云审计服务（Cloud Trace Service，以下简称CTS）记录人脸识别相关的操作事件，便于日后
- [使用服务](https://support.huaweicloud.com/productdesc-face/face_01_0003.md): 人脸识别提供了Web化的服务管理平台，即管理控制台，以及基于HTTPS请求的API管理方式。人脸识别以开放API的方式提供给用户，用户需要将人脸识别集成到第三方系统后才可使用。用户需要先在管理控制台开通人脸识别服务，使用第三方系统调用API即可使用服务，具体流程如下：申请服务在使用服务之前，您需要先登录人脸识别管理控制台开通服务，服务开通
- [约束与限制](https://support.huaweicloud.com/productdesc-face/face_01_0004.md): 受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。只支持识别JPG、PNG、JPEG、BMP格式的图片。每个用户可使用10个人脸库，每个人脸库容量为10万个人脸特征。application/json请求的body中，请使用标准Json格式。Bas
- [责任共担](https://support.huaweicloud.com/productdesc-face/face_01_0022.md): 华为云秉承“将公司对网络和业务安全性保障的责任置于公司的商业利益之上”。针对层出不穷的云安全挑战和无孔不入的云安全威胁与攻击，华为云在遵从法律法规业界标准的基础上，以安全生态圈为护城河，依托华为独有的软硬件优势，构建面向不同区域和行业的完善云服务安全保障体系。与传统的本地数据中心相比，云计算的运营方和使用方分离，提供了更好的灵活性和控制力
- [身份认证与访问控制](https://support.huaweicloud.com/productdesc-face/face_01_0023.md): 用户访问FRS的方式有多种，包括FRS控制台、API、SDK，无论访问方式封装成何种形式，其本质都是通过FRS提供的REST风格的API接口进行请求。FRS的接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。Token认证：通过Token认证调用请求。AK/SK认证：通过AK（Access Key ID）/SK（Secret Acc
- [数据保护技术](https://support.huaweicloud.com/productdesc-face/face_01_0024.md): FRS服务处理以下类型的数据：（1）用作人脸识别的OBS数据。本服务通过OBS服务将图片下载并实施分析，分析完毕后将自动删除该图片，不会留存该部分数据。如您使用OBS链接作为分析输入，需授权我们可以访问您的OBS对象。（2）从图片中提取到的特征信息。当您在人脸集中查询服务中使用搜索接口功能，如果使用添加人脸到人脸集接口，需要将图片提取到的
- [服务韧性](https://support.huaweicloud.com/productdesc-face/face_01_0025.md): 华为云数据中心按规则部署在全球各地，所有数据中心都处于正常运营状态，无一闲置。数据中心互为灾备中心，如一地出现故障，系统在满足合规政策前提下自动将客户应用和数据转离受影响区域，保证业务的连续性。为了减少由硬件故障、自然灾害或其他灾难带来的服务中断，华为云为所有数据中心提供灾难恢复计划。FRS提供三级可靠性架构，通过AZ之间容灾、AZ内实例
- [监控安全风险](https://support.huaweicloud.com/productdesc-face/face_01_0026.md): FRS提供基于云监控服务CES的监控能力，帮助用户监控账号下的FRS服务API，执行自动实时监控、告警和通知操作。用户可以实时掌握API所产生的调用成功次数、调用失败次数等信息。关于FRS支持的监控指标，以及如何创建监控告警规则等内容，请参见监控。

## 快速入门

- [FRS服务使用简介](https://support.huaweicloud.com/qs-face/face_09_0001.md): 人脸识别服务（Face Recognition Service，简称FRS），是基于人的脸部特征信息，利用计算机对人脸图像进行处理、分析和理解，用户通过实时访问和调用API获取人脸处理结果，帮助用户自动进行人脸的识别、比对以及相似度查询等。服务以开放API（Application Programming Interface，应用程序编程接
- [调用API实现人脸检测](https://support.huaweicloud.com/qs-face/face_09_0003.md): 本章节提供了通过Postman调用FRS服务人脸检测API（V2）的样例，帮助您零编码快速体验并熟悉FRS服务的使用方法。使用FRS服务API的详细步骤如下所示：步骤1：开通服务步骤2：配置环境步骤3：Token认证鉴权步骤4：调用服务注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。登录人脸识别服务控制台。控制台左上
- [调用SDK实现人脸检测](https://support.huaweicloud.com/qs-face/face_09_0002.md): 人脸识别服务软件开发工具包（FRS SDK）是对人脸识别服务提供的REST API进行的封装，以简化用户的开发工作。本章节以人脸检测API为例，介绍如何使用FRS Python SDK。使用FRS SDK的详细步骤如下所示：步骤1：开通服务步骤2：安装SDK步骤3：获取示例代码步骤4：调用服务注册华为账号并开通华为云，并完成实名认证，账号

## 用户指南

- [使用流程简介](https://support.huaweicloud.com/usermanual-face/face_11_0001.md): 人脸识别通过实时访问和调用API获取人脸处理结果，帮助用户自动进行人脸的识别、比对以及相似度查询等。用户需要具备编程能力，熟悉Java、Python、iOS、Android、Node.js编程语言。FRS服务需要用户通过调用API接口，识别图片中的人脸信息，然后返回JSON格式的识别结果，用户需要通过编码将识别结果对接到业务系统。关于人脸
- [开通服务](https://support.huaweicloud.com/usermanual-face/face_11_0002.md): 登录人脸识别管理控制台。根据业务需求，选择服务部署区域，开通所需服务（例如：人脸检测），单击右侧的“开通服务”。开通FRS服务【可选】进行OBS委托授权。调用API进行人脸的比对、检测时，可以从本地、obs、图片base64编码中读取数据。仅当您需要从对象存储服务（OBS）中读取数据，需要进行委托授权。委托授权调用API进行人脸的比对、检
- [准备数据](https://support.huaweicloud.com/usermanual-face/face_11_0003.md): 受技术与成本多种因素制约，FRS服务存在一些约束限制。以人脸检测API为例，输入数据存在以下约束。其他API的的使用约束请参见API参考。只支持识别JPG、PNG、JPEG、BMP格式的图片。application/json请求的body中，请使用标准Json格式。Base64编码中请勿使用回车换行。系统不保存用户图片。图片大小小于8MB
- [在线调试](https://support.huaweicloud.com/usermanual-face/face_11_0005.md): API Explorer在线调试工具提供API的检索、调试、代码示例生成功能。同时，集成开发环境CloudIDE，可完成代码的构建、调试、运行。本章节以人脸检测为例，介绍如何使用API Explorer调试API。注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。已开通人脸检测。登录API Explore
- [本地调用](https://support.huaweicloud.com/usermanual-face/face_11_0006.md): 本章节以人脸检测为例，介绍如何使用FRS Python SDK在本地进行开发。该接口可以对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。已开通人脸检测。获取并安装FRS Python SDK。以PyCharm为例，介绍如何安装SDK。在
- [统计API使用量](https://support.huaweicloud.com/usermanual-face/face_11_0007.md): FRS控制台支持查看API的总调用量、调用成功量、调用失败量。如果您购买了套餐包，可在“云上服务管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
- [关闭服务](https://support.huaweicloud.com/usermanual-face/face_11_0008.md): FRS服务开通后，如不使用，可登录控制台进行关闭。如果您是主账户，也可以控制子用户的服务开通、关闭状态。
- [权限管理](https://support.huaweicloud.com/usermanual-face/face_01_0011.md): 如果您需要对华为云上购买的FRS资源，为企业中的员工设置不同的访问权限，以达到不同员工之间的权限隔离，您可以使用统一身份认证服务（Identity and Access Management，简称IAM）进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功能，可以帮助您安全的控制华为云资源的访问。如果华为云账号已经能满足您的
- [创建用户组与IAM子用户](https://support.huaweicloud.com/usermanual-face/face_01_0012.md): 使用主账号登录IAM服务控制台。左侧导航窗格中，选择“用户组”页签，单击右上方的“+创建用户组”。在“创建用户组”界面，输入“用户组名称”，创建用户组。返回用户组列表，单击列表中的“授权”。勾选需要授予用户组的权限，单击“确定”，完成用户组授权。在IAM控制台中创建用户。在用户组列表中，单击新建用户组右侧的“用户组管理”。在“可选用户”列
- [为子用户分配权限](https://support.huaweicloud.com/usermanual-face/face_01_0014.md): 使用主账号登录IAM服务控制台。打开用户组列表，找到子用户所在的用户组，单击该用户组的“授权”操作。勾选需要授予用户组的权限，单击“确定”，完成用户组授权。FRS全部系统权限请参见权限管理。当现有策略不满足时，可使用FRS自定义策略。当现有策略不满足时，可使用FRS自定义策略。子账户被赋予相应权限后，可使用子账户登录FRS控制台，开通所需
- [用户登录并验证权限](https://support.huaweicloud.com/usermanual-face/face_01_0015.md): 使用新创建的IAM账户登录FRS控制台，切换至授权区域，进行验证权限。进入FRS控制台界面，单击“开通服务”，如果无法开通，提示权限不足（假设主账户只为子用户开通了FRS ReadOnlyAccess只读权限），表示“FRS ReadOnlyAccess”已生效。
- [FRS自定义策略](https://support.huaweicloud.com/usermanual-face/face_01_0013.md): 如果系统预置的权限，不满足您的授权要求，可以创建自定义策略。自定义策略中可以添加的授权项（Action）请参见权限管理。目前华为云支持以下两种方式创建自定义策略：可视化视图创建自定义策略：无需了解策略语法，按可视化视图导航栏选择云服务、操作、资源、条件等策略内容，可自动生成策略。JSON视图创建自定义策略：可以在选择策略模板后，根据具体需
- [FRS委托权限最小化](https://support.huaweicloud.com/usermanual-face/face_01_0020.md): 2025年8月15日前授予过FRS委托权限的用户。FRS服务委托授权的权限包含“Tenant Guest”和“Tenant Administrator”，由于权限过大，不满足权限最小化原则，FRS重新调整了授权的权限策略。但是之前授予过FRS委托权限的用户需要根据本指导手动进行修改，用以调小权限。使用主账号登录IAM服务控制台。在“委托”
- [人脸识别的监控指标](https://support.huaweicloud.com/usermanual-face/face_01_0005.md): 本节定义了人脸识别服务上报云监控服务的监控指标的命名空间、监控指标列表和维度定义，用户可以通过云监控服务提供管理控制台或API接口来检索人脸识别服务产生的监控指标和告警信息。SYS.FRS
- [查看监控指标](https://support.huaweicloud.com/usermanual-face/face_01_0006.md): 登录人脸识别管理控制台。在左侧导航栏中选中“服务列表”，选择云监控服务。展开左侧导航树的“云服务监控”，单击待查看的云服务。单击操作列查看监控指标，进入指标监控页面。在监控区域，您可以通过选择时长，查看对应时间的监控数据。您可以根据需要选择查看云服务“近1小时”、“近3小时”、“近12小时”、“近24小时”和“近7天”的监控数据。您可以根

## SDK参考

- [简介](https://support.huaweicloud.com/sdkreference-face/face_04_0001.md): 人脸识别服务软件开发工具包（FRS SDK）是对人脸识别服务提供的REST API进行的封装，以简化用户的开发工作。FRS SDK目前支持Java、Python、Go、.NET、Node.js、PHP版本。人脸识别接口与API对应关系请参见表1。
- [Java SDK](https://support.huaweicloud.com/sdkreference-face/face_04_0020.md): 本章节介绍人脸识别服务Java SDK，您可以参考本章节进行快速集成开发。注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。已开通人脸识别服务。如未开通，请登录人脸识别管理控制台开通所需服务。已具备开发环境，支持Java JDK 1.8 及其以上版本。登录“我的凭证 > 访问密钥”页面，获取Access Key（AK）
- [Python SDK](https://support.huaweicloud.com/sdkreference-face/face_04_0021.md): 本章节介绍人脸识别服务Python SDK，您可以参考本章节进行快速集成开发。注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。已开通人脸识别服务。如未开通，请登录人脸识别管理控制台人脸识别管理控制台开通所需服务。已具备开发环境，支持Python3及以上版本。登录“我的凭证 > 访问密钥”页面，获取Access Key
- [Go SDK](https://support.huaweicloud.com/sdkreference-face/face_04_0022.md): 本章节介绍人脸识别服务Go SDK，您可以参考本章节进行快速集成开发。注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。已开通人脸识别服务。如未开通，请登录人脸识别管理控制台人脸识别管理控制台开通所需服务。已具备开发环境，Go SDK 支持 go 1.14 及以上版本，可执行 go version 检查当前 Go 的版
- [.NET SDK](https://support.huaweicloud.com/sdkreference-face/face_04_0024.md): 本章节介绍.NET SDK，您可以参考本章节进行快速集成开发。注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。已具备开发环境，.NET SDK 适用于.NET Standard 2.0 及其以上版本；C# 4.0 及其以上版本。登录“我的凭证 > 访问密钥”页面，获取Access Key（AK）和Secret Acc
- [Node.js SDK](https://support.huaweicloud.com/sdkreference-face/face_04_0025.md): 本章节介绍新版Node.js SDK，您可以参考本章节进行快速集成开发。注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。已具备开发环境，支持Node 10.16.1 及其以上版本。登录“我的凭证 > 访问密钥”页面，获取Access Key（AK）和Secret Access Key（SK）。获取AK、SK登录“我的
- [PHP SDK](https://support.huaweicloud.com/sdkreference-face/face_04_0026.md): 本章节介绍新版PHP SDK，您可以参考本章节进行快速集成开发。注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。已具备开发环境，PHP 5.6 及以上版本，可执行 php --version 检查当前的版本信息。登录“我的凭证 > 访问密钥”页面，获取Access Key（AK）和Secret Access Key（

## API参考

- [概述](https://support.huaweicloud.com/api-face/face_02_0051.md): 欢迎使用人脸识别服务（Face Recognition Service，简称FRS），该服务能够在图像中快速检测人脸、分析人脸关键点信息、获取人脸属性、实现人脸的比对和检索。人脸识别服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。在调用人脸识别服务API之前，请确保已经充分了解人脸识别服务相关概念，详细信息请参见
- [调用说明](https://support.huaweicloud.com/api-face/face_02_0003.md): 人脸识别服务提供了RESTful API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。同时人脸识别服务还提供多种编程语言的SDK供您使用。
- [终端节点](https://support.huaweicloud.com/api-face/face_02_0057.md): 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。人脸识别服务的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。人脸识别服务终端节点区域名称区域终端节点（Endpoint）协议类型部署的服务华北-北京四cn-north-4face.cn-nort
- [约束与限制](https://support.huaweicloud.com/api-face/face_02_0078.md): 受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。只支持识别JPG、PNG、JPEG、BMP格式的图片。每个用户可使用10个人脸库，每个人脸库容量为10万个人脸特征。application/json请求的body中，请使用标准Json格式。Bas
- [基本概念](https://support.huaweicloud.com/api-face/face_02_0079.md): 账号用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账
- [API概览](https://support.huaweicloud.com/api-face/face_02_0052.md): 人脸识别服务所提供的API，均符合RESTful API设计规范，如表1所示。
- [申请服务](https://support.huaweicloud.com/api-face/face_02_0006.md): 在调用API之前，必须先申请开通服务，下面是申请服务的相关步骤。申请服务前，必须先注册云账号，并完成实名认证。登录人脸识别管理控制台。根据业务需求，选择服务部署区域，开通所需服务（例如：人脸检测），单击右侧的开通服务。香港、曼谷区域API也可以使用中国站账号进行开通；如您需要使用国际站账号开通香港、曼谷区域API，请联系客服获取开通支持。
- [构造请求](https://support.huaweicloud.com/api-face/face_02_0054.md): 本节介绍REST API请求的组成，并以调用人脸检测为例说明如何调用API，您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。请求URI由如下部分组成。{URI-scheme} :// {Endpoint} / {resource-path} ? {qu
- [认证鉴权](https://support.huaweicloud.com/api-face/face_02_0004.md): 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。Token认证：通过Token认证通用请求。AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key)加密调用请求。需要使用同一个Token鉴权时，可以缓存起来，避免频繁调用。关于Token有效期的详细说明请参见获取IAM用户Token（使
- [返回结果](https://support.huaweicloud.com/api-face/face_02_0005.md): 请求发送以后，您会收到响应，包含：状态码、响应消息头和响应消息体。状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。对于获取用户Token接口，如果调用后返回状态码为201，则表示请求成功。对应请求消息头，响应同样也有消息头，如Content-type。响应消息体通常以结构化格式返回，与响应
- [人脸检测 - DetectFace](https://support.huaweicloud.com/api-face/face_02_0084.md): 人脸检测是对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。若照片中存在多张人脸，则返回所有符合条件的人脸特征信息。前提条件：请确保您已开通人脸识别服务，具体操作方法请参见申请服务。约束限制：只支持识别JPG、PNG、JPEG、BMP格式的图片。application/json请求的body中，请使用标准Json格式。B
- [人脸比对 - CompareFace](https://support.huaweicloud.com/api-face/face_02_0085.md): 人脸比对是将两个人脸进行比对，来判断是否为同一个人，返回比对置信度。如果传入的图片中包含多个人脸，选取最大的人脸进行比对。前提条件：请确保您已开通人脸识别服务，具体操作方法请参见申请服务。约束限制：人脸比对输入的两张图片总大小。只支持识别JPG、PNG、JPEG、BMP格式的图片。application/json请求的body中，请使用标
- [动作活体检测 - DetectLive](https://support.huaweicloud.com/api-face/face_02_0100.md): 动作活体检测是实人检测的常见技术方案之一，通过判断视频中的人物动作与传入动作列表是否一致来识别视频中人物是否为活体，仅检测指定动作是否发生，不对人物真实性做校验，如果有多张人脸出现，则选取最大的人脸进行判定。新老用户均可用该接口。实人检测方案可结合具体业务诉求、成本等因素灵活设计，动作活体检测可作为其中一种技术手段，与其他方案按需组合使用
- [静默活体检测 - DetectLiveFace](https://support.huaweicloud.com/api-face/face_02_0101.md): 静默活体检测是实人检测的常见技术方案之一，基于人脸图片中可能存在的畸变、摩尔纹、反光、倒影、边框等信息，判断图片中的人脸是否来自于活体，进行实人检测，有效抵御纸质翻拍照、电子翻拍照以及视频翻拍攻击方式。静默活体检测支持单张图片，也支持多人脸图片，当图片中有多个人脸时，会检测其中最大的人脸是否为活体。新老用户均可用该接口。实人检测方案可结合
- [人脸搜索 - SearchFace](https://support.huaweicloud.com/api-face/face_02_0086.md): 人脸搜索是指在已有的人脸库中，查询与目标人脸相似的一张或者多张人脸，并返回相应的置信度。如果图片中包含多个人脸，选取图片中检测到的最大尺寸人脸作为检索的输入。支持传入图片或者faceID进行人脸搜索。前提条件：请确保您已开通人脸识别服务，具体操作方法请参见申请服务。约束限制：只支持识别JPG、PNG、JPEG、BMP格式的图片。appli
- [创建人脸库 - CreateFaceSet](https://support.huaweicloud.com/api-face/face_02_0088.md): 创建用于存储人脸特征的人脸库。您最多可以创建10个人脸库，每个人脸库最大容量为10万个人脸特征。如有更大规格的需求请联系客服。前提条件：请确保您已开通人脸搜索服务。默认情况下，一个人脸库最大可支持10万个人脸特征，一个用户最多可创建10个人脸库，最多可支持10*10万（100万）个人脸特征。您可以在API Explorer中调试该接口，支
- [查询所有人脸库 - ShowAllFaceSets](https://support.huaweicloud.com/api-face/face_02_0089.md): 查询当前用户所有人脸库的状态信息。前提条件：请确保您已开通人脸搜索服务。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要
- [查询人脸库 - ShowFaceSet](https://support.huaweicloud.com/api-face/face_02_0090.md): 查询人脸库当前的状态。前提条件：请确保您已开通人脸搜索服务。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限
- [删除人脸库 - DeleteFaceSet](https://support.huaweicloud.com/api-face/face_02_0091.md): 删除人脸库以及其中所有的人脸。人脸库数据为用户隐私数据，该数据无备份，删除时请谨慎操作。前提条件：请确保您已开通人脸搜索服务。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前AP
- [添加人脸 - AddFaces](https://support.huaweicloud.com/api-face/face_02_0093.md): 添加人脸到人脸库中。将单张图片中的人脸添加至人脸库中，支持添加最大人脸或所有人脸。前提条件：请确保您已开通人脸搜索服务。约束限制：只支持识别JPG、PNG、JPEG、BMP格式的图片。application/json请求的body中，请使用标准Json格式。Base64编码中请勿使用回车换行。系统不保存用户图片。图片大小小于8MB，由于过
- [查询人脸 - ShowFacesByLimit](https://support.huaweicloud.com/api-face/face_02_0094.md): 查询指定人脸库中人脸信息。前提条件：请确保您已开通人脸搜索服务。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见
- [更新人脸 - UpdateFace](https://support.huaweicloud.com/api-face/face_02_0095.md): 根据人脸ID（face_id）更新单张人脸信息。前提条件：请确保您已开通人脸搜索服务。application/json请求的body中，请使用标准Json格式。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果
- [删除人脸 - DeleteFace](https://support.huaweicloud.com/api-face/face_02_0096.md): 根据指定字段删除人脸库中人脸，删除后人脸库容量会相应地释放。前提条件：请确保您已开通人脸搜索服务。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用A
- [批量删除人脸 - BatchDeleteFaces](https://support.huaweicloud.com/api-face/face_02_0097.md): 自定义筛选条件，批量删除人脸库中的符合指定条件的多张人脸。前提条件：请确保您已开通人脸搜索服务。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用AP
- [自定义字段](https://support.huaweicloud.com/api-face/face_02_0012.md): 支持String，Integer，Float，Double，Boolean，Long。external_image_id，bounding_box，similarity，face_id，create_time，vector，_id，_all，_source为内置字段，自定义字段避免使用。自定义字段总个数不能超过10个，key的长度范围为[
- [sort语法](https://support.huaweicloud.com/api-face/face_02_0013.md): json array形式，排序只支持数值类型，字段重复定义会被覆盖。例1：单个排序字段"sort":[ { "location": "desc" } ]例2：多个排序字段"sort": [ { "timestamp": "
- [filter语法](https://support.huaweicloud.com/api-face/face_02_0014.md): 数值类型的范围查询，[]包含两端点值，{}不包含两端点值。rowkey:[1 TO *] 大于等于1 rowkey:[* TO 1] 小于等于1 rowkey:[1 TO 10] 1到10Request Body示例：{ "image_base64":"/9j/4AAQSkZJRgABAQAAAQABAAD..."
- [AllParam](https://support.huaweicloud.com/api-face/face_02_0016.md): 涉及到的所有参数类型的详细说明。
- [DetectFace](https://support.huaweicloud.com/api-face/face_02_0017.md): 人脸检测以及人脸比对返回的人脸结构。
- [Landmark](https://support.huaweicloud.com/api-face/face_02_0008.md): 人脸关键点结构。
- [Attributes](https://support.huaweicloud.com/api-face/face_02_0009.md): 人脸属性结构。
- [FaceQuality](https://support.huaweicloud.com/api-face/face_02_0109.md): 人脸质量结构。
- [FaceExpression](https://support.huaweicloud.com/api-face/face_02_0110.md): 人脸表情结构。
- [FaceSetFace](https://support.huaweicloud.com/api-face/face_02_0018.md): 人脸库当中的人脸结构。
- [SearchFace](https://support.huaweicloud.com/api-face/face_02_0019.md): 人脸搜索返回的人脸结构。
- [FaceSetInfo](https://support.huaweicloud.com/api-face/face_02_0020.md): 人脸库的基本信息。
- [BoundingBox](https://support.huaweicloud.com/api-face/face_02_0021.md): 人脸在图像中的位置，坐标系的原点（0,0）在左上角。
- [VideoDetectResult](https://support.huaweicloud.com/api-face/face_02_0010.md): 视频活体检测结果结构体。
- [LivelessDetectResult](https://support.huaweicloud.com/api-face/face_02_0102.md): 静默活体检测结果结构体。
- [ServiceInfo](https://support.huaweicloud.com/api-face/face_02_0011.md): 记录子服务信息。
- [WarningList](https://support.huaweicloud.com/api-face/face_02_0077.md): 视频活体检测警告信息。
- [高频报错处理办法](https://support.huaweicloud.com/api-face/face_02_0099.md): 本节内容介绍了调用API时，常见的报错及处理办法。在调用人脸识别接口时，报错“FRS.0020”，子服务未开通。该报错表示您的子服务没有开通，或url填写错误。如未开通服务请登录人脸识别服务控制台人脸识别服务控制台选择“开通服务”。如已经开通服务，请检查调用接口的请求地址是否正确。您还可以通过这个视频教程了解如何构造请求调用API：htt
- [状态码](https://support.huaweicloud.com/api-face/face_02_0082.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [错误码](https://support.huaweicloud.com/api-face/face_02_0045.md): 调用API出错后，将不会返回结果数据。调用方可根据每个API对应的错误码来定位错误原因。当调用出错时，HTTP请求返回一个4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系客服，并提供错误码，以便我们尽快帮您解决问题。异常响应样例{ "error_code": "FRS.0
- [获取项目ID/账号名](https://support.huaweicloud.com/api-face/face_02_0104.md): 登录管理控制台。鼠标移动至用户名，在下拉列表中单击我的凭证。在我的凭证页面，可以查看用户名、账号名，在项目列表中查看项目ID。查看项目ID项目ID还可以通过调用查询指定条件下的项目信息API获取。获取项目ID的接口为“GET https://{Endpoint}/v3/projects”，其中{Endpoint}为IAM的终端节点，可以从
- [获取账号ID](https://support.huaweicloud.com/api-face/face_02_0107.md): 在调用接口的时候，部分URL中需要填入账号ID（domain-id），所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下：注册并登录管理控制台。单击用户名，在下拉列表中单击我的凭证。在我的凭证页面的项目列表中查看账号ID。查看账号ID在我的凭证页面的项目列表中查看账号ID。查看账号ID
- [获取AK/SK](https://support.huaweicloud.com/api-face/face_02_0105.md): 登录人脸识别管理控制台。单击页面右上角的用户名，并选择“我的凭证”。进入“我的凭证”页面。进入“我的凭证”页面。单击“访问密钥”页签下的“新增访问密钥”。弹出“新增访问密钥”对话框。弹出“新增访问密钥”对话框。输入“登录密码”，如果绑定了手机或者邮箱，还需要获取验证码并进行验证。验证成功后，弹出访问密钥下载对话框。验证成功后，弹出访问密钥

## 常见问题

- [如何在含有多张人脸的图片中实现多人脸识别](https://support.huaweicloud.com/face_faq/face_06_0001.md): 当前人脸识别服务中，如果传入的图片中包含多个人脸，则只能选取最大的一个人脸进行识别。但是可以使用如下方法，实现一张图片中多张人脸的识别（比对/搜索）：调用人脸检测接口，可以得到多张人脸在图片中的像素位置。通过获取到的人脸位置信息，从原图中将人脸图片截出，可以参考多人脸识别Demo。再调用人脸识别接口，实现多人脸的比对/搜索。
- [人脸识别是否可使用证件类照片](https://support.huaweicloud.com/face_faq/face_06_0058.md): 人脸识别服务可以使用证件类照片，提取人脸特征时，非人脸信息不会被提取。受技术与成本多种因素制约，人脸识别服务存在一些约束限制，详细请参见约束与限制。
- [如何处理未经授权的情况](https://support.huaweicloud.com/face_faq/face_06_0004.md): 提交OBS的数据到人脸识别服务进行识别，返回未经授权：The OBS is unauthorized时，您可以通过如下步骤处理：使用OBS中的数据时，需要授权人脸识别服务能读取OBS数据，检查是否已在人脸识别服务的管理控制台单击过委托授权：如果已经授权，界面将显示为已授权。如果没有授权，请单击界面左侧委托授权。服务授权如果已经授权，界面将
- [为什么会出现识别错误的情况](https://support.huaweicloud.com/face_faq/face_06_0010.md): 底库采集的图片不清晰。前端抓拍的照片质量不好。常见的图片质量问题：背光、阴阳脸、角度不正、图片过于模糊。重新录入底库的照片，将质量差的底库照片更换。改善前端抓拍条件，调节光照，避免背光情况。运动模糊，去掉模糊照片，调节摄像头参数。
- [为什么人脸识别通过率低](https://support.huaweicloud.com/face_faq/face_06_0011.md): 人脸识别出现通过率低，前端需要抓拍多张才能找到阈值（0.93）以上的结果。底库照片质量不好。前端抓拍条件很差。前端抓拍到的人脸姿态跟底库照片的姿态相差较多，或者底库照片与抓拍的人像相差太多。重新录入底库的照片，将质量差的底库照片更换。改善前端抓拍条件，调节光照，避免背光情况。运动模糊，去掉模糊照片，调节摄像头参数。相差太多的情况，可以采用
- [为什么会请求响应过慢](https://support.huaweicloud.com/face_faq/face_06_0012.md): 用户发送https请求，需要经过tcp握手以及https证书交换，这个过程如果出现丢包情况，操作系统会进行数据包重传，重传间隔根据系统不同可能会3s或者5s。使用https长连接的方式进行请求，这样不必要每次请求都进行http建连。考虑到apigateway如果300s没有数据过去，会断开连接，这个时候需要在客户端定时发送一个数据包，维持
- [人脸检测接口可以免费调多少次](https://support.huaweicloud.com/face_faq/face_06_0023.md): 人脸识别服务中除动作活体检测以外的其他服务每月前2000次有效调用次数是免费的。
- [如何关闭已申请的服务](https://support.huaweicloud.com/face_faq/face_06_0024.md): FRS服务开通后可以在控制台进行关闭。您申请的FRS服务默认是按需收费，在不调用服务的时候不会产生扣费。
- [调用静默活体检测API，为什么在服务管理页面看不到调用量](https://support.huaweicloud.com/face_faq/face_06_0030.md): 使用按需计费的调用量，会实时刷新，如果页面没有调用量变化，请刷新页面查看。使用按QPS配额计费的调用量，暂时未在服务管理页面显示。
- [人脸识别服务是否支持私有化部署](https://support.huaweicloud.com/face_faq/face_06_0031.md): 人脸识别服务暂不支持私有化部署。人脸识别以开放API的方式提供给用户，用户通过实时访问和调用API获取人脸处理结果，帮助用户自动进行人脸的识别、比对以及相似度查询等。
- [人脸识别服务是否支持手机端（安卓和IOS）](https://support.huaweicloud.com/face_faq/face_06_0032.md): 人脸识别服务不支持手机端（安卓和IOS）的SDK。但安卓系统可以借助Java SDK、API调用云上服务。Java SDK使用介绍请参见Java SDK入门指导。API使用介绍请参见调用API实现人脸检测。
- [如何查看费用账单](https://support.huaweicloud.com/face_faq/face_06_0039.md): 汇总数据可以展示不同汇总维度下的应付金额、扣费明细等数据，每个产品只展示一条汇总数据。当月最终汇总账单将在次月3日生成，在次月4日10点后可查看和导出，请您届时关注。进入“费用账单”页面。选择“汇总”页签。设置查看月份和汇总维度，查看费用汇总数据。可以根据月份查看费用汇总数据。单击“导出月账单”，可以导出汇总账单和对账单。汇总账单：用户可
- [如何在含有多张人脸的图片中实现多人脸识别](https://support.huaweicloud.com/face_faq/face_06_0001.md): 当前人脸识别服务中，如果传入的图片中包含多个人脸，则只能选取最大的一个人脸进行识别。但是可以使用如下方法，实现一张图片中多张人脸的识别（比对/搜索）：调用人脸检测接口，可以得到多张人脸在图片中的像素位置。通过获取到的人脸位置信息，从原图中将人脸图片截出，可以参考多人脸识别Demo。再调用人脸识别接口，实现多人脸的比对/搜索。
- [人脸识别是否可使用证件类照片](https://support.huaweicloud.com/face_faq/face_06_0058.md): 人脸识别服务可以使用证件类照片，提取人脸特征时，非人脸信息不会被提取。受技术与成本多种因素制约，人脸识别服务存在一些约束限制，详细请参见约束与限制。
- [如何处理未经授权的情况](https://support.huaweicloud.com/face_faq/face_06_0004.md): 提交OBS的数据到人脸识别服务进行识别，返回未经授权：The OBS is unauthorized时，您可以通过如下步骤处理：使用OBS中的数据时，需要授权人脸识别服务能读取OBS数据，检查是否已在人脸识别服务的管理控制台单击过委托授权：如果已经授权，界面将显示为已授权。如果没有授权，请单击界面左侧委托授权。服务授权如果已经授权，界面将
- [为什么会出现识别错误的情况](https://support.huaweicloud.com/face_faq/face_06_0010.md): 底库采集的图片不清晰。前端抓拍的照片质量不好。常见的图片质量问题：背光、阴阳脸、角度不正、图片过于模糊。重新录入底库的照片，将质量差的底库照片更换。改善前端抓拍条件，调节光照，避免背光情况。运动模糊，去掉模糊照片，调节摄像头参数。
- [为什么人脸识别通过率低](https://support.huaweicloud.com/face_faq/face_06_0011.md): 人脸识别出现通过率低，前端需要抓拍多张才能找到阈值（0.93）以上的结果。底库照片质量不好。前端抓拍条件很差。前端抓拍到的人脸姿态跟底库照片的姿态相差较多，或者底库照片与抓拍的人像相差太多。重新录入底库的照片，将质量差的底库照片更换。改善前端抓拍条件，调节光照，避免背光情况。运动模糊，去掉模糊照片，调节摄像头参数。相差太多的情况，可以采用
- [为什么会请求响应过慢](https://support.huaweicloud.com/face_faq/face_06_0012.md): 用户发送https请求，需要经过tcp握手以及https证书交换，这个过程如果出现丢包情况，操作系统会进行数据包重传，重传间隔根据系统不同可能会3s或者5s。使用https长连接的方式进行请求，这样不必要每次请求都进行http建连。考虑到apigateway如果300s没有数据过去，会断开连接，这个时候需要在客户端定时发送一个数据包，维持
- [人脸检测接口可以免费调多少次](https://support.huaweicloud.com/face_faq/face_06_0023.md): 人脸识别服务中除动作活体检测以外的其他服务每月前2000次有效调用次数是免费的。
- [如何关闭已申请的服务](https://support.huaweicloud.com/face_faq/face_06_0024.md): FRS服务开通后可以在控制台进行关闭。您申请的FRS服务默认是按需收费，在不调用服务的时候不会产生扣费。
- [调用静默活体检测API，为什么在服务管理页面看不到调用量](https://support.huaweicloud.com/face_faq/face_06_0030.md): 使用按需计费的调用量，会实时刷新，如果页面没有调用量变化，请刷新页面查看。使用按QPS配额计费的调用量，暂时未在服务管理页面显示。
- [人脸识别服务是否支持私有化部署](https://support.huaweicloud.com/face_faq/face_06_0031.md): 人脸识别服务暂不支持私有化部署。人脸识别以开放API的方式提供给用户，用户通过实时访问和调用API获取人脸处理结果，帮助用户自动进行人脸的识别、比对以及相似度查询等。
- [人脸识别服务是否支持手机端（安卓和IOS）](https://support.huaweicloud.com/face_faq/face_06_0032.md): 人脸识别服务不支持手机端（安卓和IOS）的SDK。但安卓系统可以借助Java SDK、API调用云上服务。Java SDK使用介绍请参见Java SDK入门指导。API使用介绍请参见调用API实现人脸检测。
- [如何查看费用账单](https://support.huaweicloud.com/face_faq/face_06_0039.md): 汇总数据可以展示不同汇总维度下的应付金额、扣费明细等数据，每个产品只展示一条汇总数据。当月最终汇总账单将在次月3日生成，在次月4日10点后可查看和导出，请您届时关注。进入“费用账单”页面。选择“汇总”页签。设置查看月份和汇总维度，查看费用汇总数据。可以根据月份查看费用汇总数据。单击“导出月账单”，可以导出汇总账单和对账单。汇总账单：用户可
- [获取Token](https://support.huaweicloud.com/face_faq/face_06_0061.md): Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。下载并安装Postman。Postman建议使用7.24.0版本。Postman建议使用7.24.0版本。下载人脸识别服务Postman配置文件。下载地址：FRS-API.postman_collection.json。下载地址：F
- [有哪些途径可以使用人脸识别的API](https://support.huaweicloud.com/face_faq/face_06_0002.md): 共有三种方式可以基于已构建好的请求消息发起请求。cURLcURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，并接收响应消息。cURL适用于接口调试。cURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，
- [如何通过Postman获取用户Token](https://support.huaweicloud.com/face_faq/face_06_0025.md): Postman是网页调试与辅助接口调用的工具，具有界面简洁清晰、操作方便快捷的特性，可以处理用户发送的HTTP请求，例如：GET，PUT、POST，DELETE等，支持用户修改HTTP请求中的参数并返回响应数据。Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。本章节指导用户如何通
- [如何通过API Explorer获取用户Token](https://support.huaweicloud.com/face_faq/face_06_0036.md): API Explorer是华为云为开发者提供的一站式API解决方案的统一平台，集成华为云服务开放API，支持全量快速检索、可视化调试、帮助文档，帮助开发者快速查找、学习API和定位修复错误。Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。本章节指导用户如何通过API Explor
- [通过OBS方式传入图片报错FRS.0022怎么办](https://support.huaweicloud.com/face_faq/face_06_0009.md): OBS路径错误。OBS桶并不是当前用户的桶。注册服务时，没有将OBS权限授予FRS服务。图片的路径按照/bucket/image-path格式，不需要带上域名。人脸服务只能访问当前账号的OBS桶。账号需要将OBS权限授予人脸服务，人脸服务才能访问OBS上的图片。
- [QPS是什么](https://support.huaweicloud.com/face_faq/face_06_0028.md): QPS（Queries Per Second）即每秒钟的请求量。调用人脸识别的接口收费，提供按QPS配额计费的方式，用户可以选择所需的QPS配额，具体计费价格请参见人脸识别价格详情。系统承诺的QPS是在输入图片分辨率为640*480，200KB左右的图片大小时服务所能承受的规格，超过输入规格系统性能会有下降。如有疑问请及时咨询服务人员。
- [QPS限流时如何增加QPS配额](https://support.huaweicloud.com/face_faq/face_06_0033.md): 调用人脸识别API时，报错“FRS.0033”。该报错表示您当前请求数太多，超过流控限制。建议控制请求策略或者进行重试。增加QPS配额。请参考人脸识别价格详情，按照您的需求增加QPS配额。变更QPS规格。登录人脸识别管理控制台。在左侧导航栏中选择“云上服务管理”。单击“购买QPS套餐”对于支持QPS方式调用的接口，调整QPS套餐。购买时，
- [如何获取正确的终端节点（Endpoint）](https://support.huaweicloud.com/face_faq/face_06_0034.md): 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同。人脸识别服务的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。人脸识别服务终端节点区域名称区域终端节点（Endpoint）协议类型部署的服务华北-北京四cn-north-4face.cn-north-4.myhuaweicloud.comHTT
- [如何获取图片的base64编码](https://support.huaweicloud.com/face_faq/face_06_0035.md): 本节以Python为例，介绍如何将本地图片，转换为base64编码。您也可以使用在线的图片转base64工具。使用时，需要将代码的d:\demo.jpg替换为实际图片路径。
- [人脸搜索接口中关于top_n参数如何设置](https://support.huaweicloud.com/face_faq/face_06_0008.md): 请求该接口不传top_n参数时，默认返回查询到最相似的10张人脸，top_n允许设置最大值是1000。
- [为什么使用人脸识别返回数据为空](https://support.huaweicloud.com/face_faq/face_06_0007.md): 上传照片中的人像可能存在横置或倒置等情况。尽量选择纯色无干扰背景，保证图片中人像清晰。上传的人脸图片要求：侧脸不超过30°，抬头低头不超过15°。图片中人脸需要保持竖置正脸，如果人像是横置或倒置，可以选择旋转至竖置正脸后重试。
- [人脸识别所需最低带宽是多少](https://support.huaweicloud.com/face_faq/face_06_0013.md): 图片大小和并发都由客户控制，可根据自己业务情况选择宽带大小，人脸识别没有对宽带做最小限制。
- [如何获取OBS桶内最近图片的地址URL](https://support.huaweicloud.com/face_faq/face_06_0014.md): 将对象权限设置为匿名用户读取权限，通过分享对象URL，匿名用户通过分享的链接地址可访问对象数据。已经设置匿名用户对该对象的读取权限。权限开启方法请参见对匿名用户授予指定对象的公共读权限。不能对已加密的对象进行共享。在OBS管理控制台左侧导航栏选择“桶列表”。在桶列表单击待操作的桶，进入“概览”页面。在左侧导航栏，单击“对象”。单击待共享对
- [人脸识别上传的人脸图片还可以查询到图片数据吗](https://support.huaweicloud.com/face_faq/face_06_0015.md): 人脸识别不存储客户人脸图片，只是根据客户的图片来检测人脸参数，只存储人脸特征。如果需要存储图片数据可参考以下方法：可以开通华为云OBS，存储人脸图片。人脸图片可以存储在客户自己的数据库中。
- [人脸搜索是否需要使用OBS服务](https://support.huaweicloud.com/face_faq/face_06_0038.md): 人脸搜索是指在已有的人脸库中，查询与目标人脸相似的一张或者多张人脸。在使用人脸搜索时，需创建人脸库（使用人脸库，也以开通人脸搜索服务为前提）。人脸库创建在华为云对象存储服务（OBS）中，您可以参考API文档“人脸库资源管理”和“人脸资源管理”相关章节，对人脸库和人脸资源进行管理。由于应用可能需要使用对象存储服务（OBS）中的数据，人脸识别
- [如何查看API的使用量](https://support.huaweicloud.com/face_faq/face_06_0044.md): 登录人脸识别管理控制台。在左侧导航栏中选择“云上服务管理”，查看API的使用量。
- [获取Token](https://support.huaweicloud.com/face_faq/face_06_0061.md): Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。下载并安装Postman。Postman建议使用7.24.0版本。Postman建议使用7.24.0版本。下载人脸识别服务Postman配置文件。下载地址：FRS-API.postman_collection.json。下载地址：F
- [有哪些途径可以使用人脸识别的API](https://support.huaweicloud.com/face_faq/face_06_0002.md): 共有三种方式可以基于已构建好的请求消息发起请求。cURLcURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，并接收响应消息。cURL适用于接口调试。cURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，
- [如何通过Postman获取用户Token](https://support.huaweicloud.com/face_faq/face_06_0025.md): Postman是网页调试与辅助接口调用的工具，具有界面简洁清晰、操作方便快捷的特性，可以处理用户发送的HTTP请求，例如：GET，PUT、POST，DELETE等，支持用户修改HTTP请求中的参数并返回响应数据。Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。本章节指导用户如何通
- [如何通过API Explorer获取用户Token](https://support.huaweicloud.com/face_faq/face_06_0036.md): API Explorer是华为云为开发者提供的一站式API解决方案的统一平台，集成华为云服务开放API，支持全量快速检索、可视化调试、帮助文档，帮助开发者快速查找、学习API和定位修复错误。Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。本章节指导用户如何通过API Explor
- [通过OBS方式传入图片报错FRS.0022怎么办](https://support.huaweicloud.com/face_faq/face_06_0009.md): OBS路径错误。OBS桶并不是当前用户的桶。注册服务时，没有将OBS权限授予FRS服务。图片的路径按照/bucket/image-path格式，不需要带上域名。人脸服务只能访问当前账号的OBS桶。账号需要将OBS权限授予人脸服务，人脸服务才能访问OBS上的图片。
- [QPS是什么](https://support.huaweicloud.com/face_faq/face_06_0028.md): QPS（Queries Per Second）即每秒钟的请求量。调用人脸识别的接口收费，提供按QPS配额计费的方式，用户可以选择所需的QPS配额，具体计费价格请参见人脸识别价格详情。系统承诺的QPS是在输入图片分辨率为640*480，200KB左右的图片大小时服务所能承受的规格，超过输入规格系统性能会有下降。如有疑问请及时咨询服务人员。
- [QPS限流时如何增加QPS配额](https://support.huaweicloud.com/face_faq/face_06_0033.md): 调用人脸识别API时，报错“FRS.0033”。该报错表示您当前请求数太多，超过流控限制。建议控制请求策略或者进行重试。增加QPS配额。请参考人脸识别价格详情，按照您的需求增加QPS配额。变更QPS规格。登录人脸识别管理控制台。在左侧导航栏中选择“云上服务管理”。单击“购买QPS套餐”对于支持QPS方式调用的接口，调整QPS套餐。购买时，
- [如何获取正确的终端节点（Endpoint）](https://support.huaweicloud.com/face_faq/face_06_0034.md): 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同。人脸识别服务的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。人脸识别服务终端节点区域名称区域终端节点（Endpoint）协议类型部署的服务华北-北京四cn-north-4face.cn-north-4.myhuaweicloud.comHTT
- [如何获取图片的base64编码](https://support.huaweicloud.com/face_faq/face_06_0035.md): 本节以Python为例，介绍如何将本地图片，转换为base64编码。您也可以使用在线的图片转base64工具。使用时，需要将代码的d:\demo.jpg替换为实际图片路径。
- [人脸搜索接口中关于top_n参数如何设置](https://support.huaweicloud.com/face_faq/face_06_0008.md): 请求该接口不传top_n参数时，默认返回查询到最相似的10张人脸，top_n允许设置最大值是1000。
- [为什么使用人脸识别返回数据为空](https://support.huaweicloud.com/face_faq/face_06_0007.md): 上传照片中的人像可能存在横置或倒置等情况。尽量选择纯色无干扰背景，保证图片中人像清晰。上传的人脸图片要求：侧脸不超过30°，抬头低头不超过15°。图片中人脸需要保持竖置正脸，如果人像是横置或倒置，可以选择旋转至竖置正脸后重试。
- [人脸识别所需最低带宽是多少](https://support.huaweicloud.com/face_faq/face_06_0013.md): 图片大小和并发都由客户控制，可根据自己业务情况选择宽带大小，人脸识别没有对宽带做最小限制。
- [如何获取OBS桶内最近图片的地址URL](https://support.huaweicloud.com/face_faq/face_06_0014.md): 将对象权限设置为匿名用户读取权限，通过分享对象URL，匿名用户通过分享的链接地址可访问对象数据。已经设置匿名用户对该对象的读取权限。权限开启方法请参见对匿名用户授予指定对象的公共读权限。不能对已加密的对象进行共享。在OBS管理控制台左侧导航栏选择“桶列表”。在桶列表单击待操作的桶，进入“概览”页面。在左侧导航栏，单击“对象”。单击待共享对
- [人脸识别上传的人脸图片还可以查询到图片数据吗](https://support.huaweicloud.com/face_faq/face_06_0015.md): 人脸识别不存储客户人脸图片，只是根据客户的图片来检测人脸参数，只存储人脸特征。如果需要存储图片数据可参考以下方法：可以开通华为云OBS，存储人脸图片。人脸图片可以存储在客户自己的数据库中。
- [人脸搜索是否需要使用OBS服务](https://support.huaweicloud.com/face_faq/face_06_0038.md): 人脸搜索是指在已有的人脸库中，查询与目标人脸相似的一张或者多张人脸。在使用人脸搜索时，需创建人脸库（使用人脸库，也以开通人脸搜索服务为前提）。人脸库创建在华为云对象存储服务（OBS）中，您可以参考API文档“人脸库资源管理”和“人脸资源管理”相关章节，对人脸库和人脸资源进行管理。由于应用可能需要使用对象存储服务（OBS）中的数据，人脸识别
- [如何查看API的使用量](https://support.huaweicloud.com/face_faq/face_06_0044.md): 登录人脸识别管理控制台。在左侧导航栏中选择“云上服务管理”，查看API的使用量。
- [调用API报错时怎么处理](https://support.huaweicloud.com/face_faq/face_06_0003.md): 根据API调用返回结果或者错误码查找原因。检查访问密钥AK/SK是否获取成功。检查Token是否填写正确或者已过期。检查API调用方法是否正确。您可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。
- [账密报错“The username or password is wrong.”](https://support.huaweicloud.com/face_faq/face_06_0053.md): 获取Token时出现“The username or password is wrong.”。请确认近期华为云账号是否有升级为华为账号。当前，如果您通过华为账号入口登录华为云账号，就会指引升级。华为云账号若已升级为华为账号，将不支持获取账号Token。建议您创建一个IAM账户，使用该账户获取Token。登录华为云控制台，在右上角用户名处选
- [调用API操作APIG.0301怎么办](https://support.huaweicloud.com/face_faq/face_06_0042.md): 在调用人脸识别接口时，报错“APIG.0301”。该报错显示认证鉴权失败，Token或AK/SK填写错误导致该报错。调用接口时有两种认证方式。Token认证或AK/SK认证。请参考认证鉴权，获取正确的Token或AK/SK，在调用接口时，确保复制的Token或AK/SK正确。
- [调用API报错FRS.0028怎么办](https://support.huaweicloud.com/face_faq/face_06_0041.md): 在调用人脸识别接口时，报错“FRS.0028”。该报错表示Project ID跟Token不匹配。获取准确的Project ID。在华为云首页右上角，单击“控制台”。在右上角的用户名中选择“我的凭证”。在“我的凭证”界面，API凭证页签中，查看账号名、账号账号、用户名、用户ID、项目名称、项目ID。
- [调用API报错FRS.0020怎么办](https://support.huaweicloud.com/face_faq/face_06_0027.md): 在调用人脸识别接口时，报错“FRS.0020”，子服务未开通。该报错表示您的子服务没有开通。产生该报错的原因有以下两种：API没有开通，就直接调用，导致报错。开通的API与实际调用的不一致，导致报错。如未开通服务请登录人脸识别服务控制台选择“开通服务”。开通服务如已开通服务，请检查开通服务的区域（或账号）与调用服务的区域（或账号）是否一致
- [调用API报错"APIG.0101","API not exist or not published to environment"，该怎么办](https://support.huaweicloud.com/face_faq/face_06_0026.md): 在调用人脸识别接口时，报错“APIG.0101”，“The API does not exist or has not been published in the environment”。该报错表示调用接口时使用的请求地址或者URL不存在或没有发布。例如，调用人脸识别中查询服务状态接口时报错APIG.0101，解决方法如下所示。参考AP
- [调用API报错“The token must be updated”怎么办](https://support.huaweicloud.com/face_faq/face_06_0046.md): 以下两种情况可能会导致调用API时返回The token must be update：您获取的Token已过期，关于Token有效期的详细说明请参见获取IAM用户Token（使用密码），当Token过期时会返回该提示信息。您的账户出现欠费，充值后，未重新获取Token，这种情况下也会导致返回提示信息。若出现该提示，您需要重新从IAM服务
- [获取Token报错](https://support.huaweicloud.com/face_faq/face_06_0056.md): 获取Token时，请依据报错信息，选择相应的解决方案。账密报错The username or password is wrong返回The userInfo is wrong请正确填写username和domainname，一般情况下，username=domainname。如不确定，可登录“我的凭证”页面查看，如果使用IAM账号获取To
- [如何解决账号锁定“The account is locked.”](https://support.huaweicloud.com/face_faq/face_06_0057.md): 华为云账号锁定后，请等待15分钟，重新进行登录。如果需要修改密码，请参见重置密码（可选）。主动修改密码如果您的华为云账号暂未升级成华为账号，且您记得当前密码，需要主动修改密码，可以在“基本信息”中修改自己的密码。如果您的华为云账号已升级成华为账号，且您记得当前密码，需要主动修改密码，可以在“基本信息”中单击“华为账号信息”右侧的“前往管理
- [调用API报错时怎么处理](https://support.huaweicloud.com/face_faq/face_06_0003.md): 根据API调用返回结果或者错误码查找原因。检查访问密钥AK/SK是否获取成功。检查Token是否填写正确或者已过期。检查API调用方法是否正确。您可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。
- [账密报错“The username or password is wrong.”](https://support.huaweicloud.com/face_faq/face_06_0053.md): 获取Token时出现“The username or password is wrong.”。请确认近期华为云账号是否有升级为华为账号。当前，如果您通过华为账号入口登录华为云账号，就会指引升级。华为云账号若已升级为华为账号，将不支持获取账号Token。建议您创建一个IAM账户，使用该账户获取Token。登录华为云控制台，在右上角用户名处选
- [调用API操作APIG.0301怎么办](https://support.huaweicloud.com/face_faq/face_06_0042.md): 在调用人脸识别接口时，报错“APIG.0301”。该报错显示认证鉴权失败，Token或AK/SK填写错误导致该报错。调用接口时有两种认证方式。Token认证或AK/SK认证。请参考认证鉴权，获取正确的Token或AK/SK，在调用接口时，确保复制的Token或AK/SK正确。
- [调用API报错FRS.0028怎么办](https://support.huaweicloud.com/face_faq/face_06_0041.md): 在调用人脸识别接口时，报错“FRS.0028”。该报错表示Project ID跟Token不匹配。获取准确的Project ID。在华为云首页右上角，单击“控制台”。在右上角的用户名中选择“我的凭证”。在“我的凭证”界面，API凭证页签中，查看账号名、账号账号、用户名、用户ID、项目名称、项目ID。
- [调用API报错FRS.0020怎么办](https://support.huaweicloud.com/face_faq/face_06_0027.md): 在调用人脸识别接口时，报错“FRS.0020”，子服务未开通。该报错表示您的子服务没有开通。产生该报错的原因有以下两种：API没有开通，就直接调用，导致报错。开通的API与实际调用的不一致，导致报错。如未开通服务请登录人脸识别服务控制台选择“开通服务”。开通服务如已开通服务，请检查开通服务的区域（或账号）与调用服务的区域（或账号）是否一致
- [调用API报错"APIG.0101","API not exist or not published to environment"，该怎么办](https://support.huaweicloud.com/face_faq/face_06_0026.md): 在调用人脸识别接口时，报错“APIG.0101”，“The API does not exist or has not been published in the environment”。该报错表示调用接口时使用的请求地址或者URL不存在或没有发布。例如，调用人脸识别中查询服务状态接口时报错APIG.0101，解决方法如下所示。参考AP
- [调用API报错“The token must be updated”怎么办](https://support.huaweicloud.com/face_faq/face_06_0046.md): 以下两种情况可能会导致调用API时返回The token must be update：您获取的Token已过期，关于Token有效期的详细说明请参见获取IAM用户Token（使用密码），当Token过期时会返回该提示信息。您的账户出现欠费，充值后，未重新获取Token，这种情况下也会导致返回提示信息。若出现该提示，您需要重新从IAM服务
- [获取Token报错](https://support.huaweicloud.com/face_faq/face_06_0056.md): 获取Token时，请依据报错信息，选择相应的解决方案。账密报错The username or password is wrong返回The userInfo is wrong请正确填写username和domainname，一般情况下，username=domainname。如不确定，可登录“我的凭证”页面查看，如果使用IAM账号获取To
- [如何解决账号锁定“The account is locked.”](https://support.huaweicloud.com/face_faq/face_06_0057.md): 华为云账号锁定后，请等待15分钟，重新进行登录。如果需要修改密码，请参见重置密码（可选）。主动修改密码如果您的华为云账号暂未升级成华为账号，且您记得当前密码，需要主动修改密码，可以在“基本信息”中修改自己的密码。如果您的华为云账号已升级成华为账号，且您记得当前密码，需要主动修改密码，可以在“基本信息”中单击“华为账号信息”右侧的“前往管理
- [什么是区域和可用区域](https://support.huaweicloud.com/face_faq/face_06_0005.md): 使用区域和可用区来描述数据中心的位置，您可以在特定的区域、可用区创建资源。区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Re
- [什么是区域和可用区域](https://support.huaweicloud.com/face_faq/face_06_0005.md): 使用区域和可用区来描述数据中心的位置，您可以在特定的区域、可用区创建资源。区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Re
- [使用FRS服务需要的权限](https://support.huaweicloud.com/face_faq/face_06_0048.md): 使用FRS服务无需权限配置，在管理控制台开通服务后即可使用。使用FRS服务时，如果您需要使用华为云对象存储服务（OBS）中的数据，请开通对象存储服务OBS授权，可在控制台进行开通。FRS服务支持IAM细粒度划分策略。
- [FRS是否支持IAM细粒度划分](https://support.huaweicloud.com/face_faq/face_06_0059.md): FRS服务支持IAM细粒度划分策略，IAM账号与主账号可具备不同的FRS操作权限。您可以使用IAM的用户管理功能，给员工或应用程序创建IAM用户，可避免分享自己的账号密码。详细创建步骤请参见创建IAM用户。
- [因权限造成的调用API失败](https://support.huaweicloud.com/face_faq/face_06_0060.md): 子用户已经开通了人脸识别服务，但是调用时还是提示未订阅。确认调用API所用的区域，与开通服务区域是否一致。需要核实主账户赋予的权限，并核实开通服务的子账户与调用API时使用的子账户是否相同。
- [使用FRS服务需要的权限](https://support.huaweicloud.com/face_faq/face_06_0048.md): 使用FRS服务无需权限配置，在管理控制台开通服务后即可使用。使用FRS服务时，如果您需要使用华为云对象存储服务（OBS）中的数据，请开通对象存储服务OBS授权，可在控制台进行开通。FRS服务支持IAM细粒度划分策略。
- [FRS是否支持IAM细粒度划分](https://support.huaweicloud.com/face_faq/face_06_0059.md): FRS服务支持IAM细粒度划分策略，IAM账号与主账号可具备不同的FRS操作权限。您可以使用IAM的用户管理功能，给员工或应用程序创建IAM用户，可避免分享自己的账号密码。详细创建步骤请参见创建IAM用户。
- [因权限造成的调用API失败](https://support.huaweicloud.com/face_faq/face_06_0060.md): 子用户已经开通了人脸识别服务，但是调用时还是提示未订阅。确认调用API所用的区域，与开通服务区域是否一致。需要核实主账户赋予的权限，并核实开通服务的子账户与调用API时使用的子账户是否相同。
- [使用FRS服务，是否会保存用户数据](https://support.huaweicloud.com/face_faq/face_06_0055.md): FRS服务坚持“华为云始终把可信作为产品质量的第一要素”的理念，我们基于安全、合规、隐私、韧性、透明，为您提供有技术、有未来、值得信赖的云服务。具体的声明请参考隐私政策声明和法律声明，可信资源请参见白皮书资源。关于人脸识别的相关声明请参见人脸识别服务声明。
- [使用FRS服务，是否会保存用户数据](https://support.huaweicloud.com/face_faq/face_06_0055.md): FRS服务坚持“华为云始终把可信作为产品质量的第一要素”的理念，我们基于安全、合规、隐私、韧性、透明，为您提供有技术、有未来、值得信赖的云服务。具体的声明请参考隐私政策声明和法律声明，可信资源请参见白皮书资源。关于人脸识别的相关声明请参见人脸识别服务声明。