检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
云容器引擎-成长地图 | 华为云 人脸识别服务 人脸识别服务（Face Recognition Service，简称FRS），是基于人的脸部特征信息，利用计算机对人脸图像进行处理、分析和理解，进行身份识别的一种智能服务。 API参考 图说ECS 立即使用 立即使用 成长地图 由浅入深，带您玩转FRS
返回结果 请求发送以后，您会收到响应，包含：状态码、响应消息头和响应消息体。 状态码 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对
AllParam 功能介绍 涉及到的所有参数类型的详细说明。 参数说明 表1 结果格式说明表 名称 类型 说明 project_id String 项目ID，获取方法请参见获取项目ID/账号名/AK/SK。 image_url String 图片的URL路径，目前仅支持华为云上O
FaceSetFace 功能介绍 人脸库当中的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸ID，由系统内部生成的唯一ID。
SearchFace 功能介绍 人脸搜索返回的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸ID，由系统内部生成的唯一ID。
Attributes 功能介绍 人脸属性结构。 参数说明 表1 结构格式说明表 名称 类型 说明 age Integer 年龄。 dress List of strings 包含glass和hat两个属性结果。 glass String 是否戴眼镜： yes：戴眼镜 none：未戴眼镜
调用API报错FRS.0020怎么办 问题现象 在调用人脸识别接口时，报错“FRS.0020”，子服务未开通。 该报错表示您的子服务没有开通。 产生该报错的原因有以下两种： API没有开通，就直接调用，导致报错。 开通的API与实际调用的不一致，导致报错。 解决方法 如未开通服务
获取Token Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。 下载地址：FRS-API.postman_collection
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 Token认证：通过Token认证通用请求。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key)加密调用请求。 Token认证 需要使用同一个Token鉴权时，可以缓存起来，避免频繁调用。
开通服务 开通服务 登录人脸识别管理控制台。 根据业务需求，选择服务部署区域，开通所需服务（例如：人脸检测），单击右侧的“开通服务”。 图1 开通FRS服务 【可选】进行OBS委托授权。 调用API进行人脸的比对、检测时，可以从本地、obs、图片base64编码中读取数据。仅当您
公共数据结构 自定义字段 sort语法 filter语法 消息对象结构
调用API实现人脸检测 本章节提供了通过Postman调用FRS服务人脸检测API（V2）的样例，帮助您零编码快速体验并熟悉FRS服务的使用方法。 使用FRS服务API的详细步骤如下所示： 步骤1：开通服务 步骤2：配置环境 步骤3：Token认证鉴权 步骤4：调用服务 准备工作
消息对象结构 AllParam DetectFace Landmark Attributes FaceQuality FaceExpression FaceSetFace SearchFace FaceSetInfo BoundingBox VideoDetectResult LivelessDetectResult
高频报错处理办法 操作场景 本节内容介绍了调用API时，常见的报错及处理办法。 表1 调用API高频报错处理办法 常见报错 处理办法 FRS.0020子服务未开通 开通该服务，检查开通服务的区域（或账号）与调用服务的区域（或账号）是否一致，检查API的URL是否拼写正确。 APIG
错误码类 调用API报错时怎么处理 账密报错“The username or password is wrong.” 调用API操作APIG.0301怎么办 调用API报错FRS.0028怎么办 调用API报错FRS.0020怎么办 调用API报错"APIG.0101","API
Node.js SDK 本章节介绍新版Node.js SDK，您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。 已具备开发环境，支持Node 10.16.1 及其以上版本。 登录“我的凭证 > 访问秘钥”页面，获取Access
VideoDetectResult 功能介绍 视频活体检测结果结构体。 参数说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64。 actions List 动作列表。详细参数请参见表
构造请求 本节介绍REST API请求的组成，并以调用人脸检测为例说明如何调用API，您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。 请求URI 请求URI由如下部分组成。 {URI-scheme}
WarningList 功能介绍 视频活体检测警告信息。 参数说明 表1 结构格式说明 名称 类型 说明 warningCode Integer 警告ID。 warningMsg String 警告消息。 表2 错误提示 warningCode warningMsg 1 人脸没有朝向前方。
API使用类 获取Token 有哪些途径可以使用人脸识别的API 如何通过Postman获取用户Token 如何通过API Explorer获取用户Token 通过OBS方式传入图片报错FRS.0022怎么办 QPS是什么 QPS限流时如何增加QPS配额 如何获取正确的终端节点（Endpoint）
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
