检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 人脸识别服务所提供的API，均符合RESTful API设计规范，如表1所示。 表1 人脸识别API 类型 API 说明 人脸检测 人脸检测 人脸检测是对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。 人脸比对 人脸比对 人脸比对是将两个人脸进行比
修订记录 发布日期 修改说明 2021-10-21 新版SDK正式发布，旧版SDK停止维护。
调用说明 人脸识别服务提供了RESTful API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题： 使用前必读
人脸资源管理 添加人脸 查询人脸 更新人脸 删除人脸 批量删除人脸 父主题： API
高频报错处理办法 操作场景 本节内容介绍了调用API时，常见的报错及处理办法。 表1 调用API高频报错处理办法 常见报错 处理办法 FRS.0020子服务未开通 开通该服务，检查开通服务的区域（或账号）与调用服务的区域（或账号）是否一致，检查API的URL是否拼写正确。 APIG
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
QPS是什么 QPS（Queries Per Second）即每秒钟的请求量。调用人脸识别的接口收费，提供按QPS配额计费的方式，用户可以选择所需的QPS配额，具体计费价格请参见人脸识别价格详情。 系统承诺的QPS是在输入图片分辨率为640*480，200KB左右的图片大小时服务
人脸检测 功能介绍 人脸检测是对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。若照片中存在多张人脸，则返回所有符合条件的人脸特征信息。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。 约束限制： 只支持识别JPG、PNG、JPEG、BMP格式的图片。
人脸比对 功能介绍 人脸比对是将两个人脸进行比对，来判断是否为同一个人，返回比对置信度。如果传入的图片中包含多个人脸，选取最大的人脸进行比对。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。 约束限制： 人脸比对输入的两张图片总大小。 只支持识别JPG、PNG、JPEG、BMP格式的图片。
错误码 调用API出错后，将不会返回结果数据。调用方可根据每个API对应的错误码来定位错误原因。当调用出错时，HTTP请求返回一个4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系客服，并提供错误码，以便我们尽快帮您解决问题。
FRS自定义策略 如果系统预置的权限，不满足您的授权要求，可以创建自定义策略。自定义策略中可以添加的授权项（Action）请参见权限管理。 目前华为云支持以下两种方式创建自定义策略： 可视化视图创建自定义策略：无需了解策略语法，按可视化视图导航栏选择云服务、操作、资源、条件等策略内容，可自动生成策略。
用户登录并验证权限 使用新创建的IAM账户登录FRS控制台，切换至授权区域，进行验证权限。 进入FRS控制台界面，单击“开通服务”，如果无法开通，提示权限不足（假设主账户只为子用户开通了FRS ReadOnlyAccess只读权限），表示“FRS ReadOnlyAccess”已生效。
sort语法 json array形式，排序只支持数值类型，字段重复定义会被覆盖。 例1：单个排序字段 "sort":[ { "location": "desc" } ] 例2：多个排序字段 "sort": [
约束与限制 受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可免费使用10个人脸库，每个人脸库容量为1
基本概念 账号 用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。 用户 由账号在IAM中创建的用户，是云
人脸搜索 功能介绍 人脸搜索是指在已有的人脸库中，查询与目标人脸相似的一张或者多张人脸，并返回相应的置信度。如果图片中包含多个人脸，选取图片中检测到的最大尺寸人脸作为检索的输入。 支持传入图片或者faceID进行人脸搜索。 前提条件： 请确保您已开通人脸识别服务，具体操作方法请参见申请服务。
调用API实现人脸检测 本章节提供了通过Postman调用FRS服务人脸检测API（V2）的样例，帮助您零编码快速体验并熟悉FRS服务的使用方法。 使用FRS服务API的详细步骤如下所示： 步骤1：开通服务 步骤2：配置环境 步骤3：Token认证鉴权 步骤4：调用服务 准备工作
区域与可用区 什么是区域和可用区域
数据安全类 使用FRS服务，是否会保存用户数据
活体检测 动作活体检测 静默活体检测 父主题： API
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
