检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
获取Token Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。 下载地址：FRS-API.postman_collection
Attributes 功能介绍 人脸属性结构。 参数说明 表1 结构格式说明表 名称 类型 说明 age Integer 年龄。 dress List of strings 包含glass和hat两个属性结果。 glass String 是否戴眼镜： yes：戴眼镜 none：未戴眼镜
关闭服务 FRS服务开通后，如不使用，可登录控制台进行关闭。 如果您是主账户，也可以控制子用户的服务开通、关闭状态。 图1 关闭服务 图2 控制子用户的开通、关闭
调用API报错FRS.0020怎么办 问题现象 在调用人脸识别接口时，报错“FRS.0020”，子服务未开通。 该报错表示您的子服务没有开通。 产生该报错的原因有以下两种： API没有开通，就直接调用，导致报错。 开通的API与实际调用的不一致，导致报错。 解决方法 如未开通服务
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。
申请服务 在调用API之前，必须先申请开通服务，下面是申请服务的相关步骤。 申请服务前，必须先注册云账号，并完成实名认证。 申请步骤 登录人脸识别管理控制台。 根据业务需求，选择服务部署区域，开通所需服务（例如：人脸检测），单击右侧的“开通服务”。 香港、曼谷区域API也可以使用
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID（domain-id），所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 注册并登录管理控制台。 单击用户名，在下拉列表中单击“我的凭证”。 在“我的凭证”页面的项目列表中查看账号ID。 图1 查看账号ID
DetectFace 功能介绍 人脸检测以及人脸比对返回的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 landmark Landmark
应用场景 身份验证 使用人脸检测与比对功能，可进行身份核实，适用于机场、海关等人证合一验证场景。 图1 身份验证 电子考勤 人脸检测及比对功能适用于客户企业对员工进行电子考勤。 客流分析 客流分析对于商场具有重要价值。基于人脸识别、搜索技术，帮助客户精准营销。
FaceExpression 功能介绍 人脸表情结构。 参数说明 表1 结构格式说明表 名称 类型 说明 type String 人脸表情类型 neutral：中性 happy：高兴 fear：害怕 surprise：惊讶 sad：伤心 angry：生气 disgust：厌恶 unknown：图片质量问题导致未识别
LivelessDetectResult 功能介绍 静默活体检测结果结构体。 结构格式说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64字符串。 confidence Double
有哪些途径可以使用人脸识别的API 共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，并接收响应消息。cURL适用于接口调试。 编码 通过编码调用接口，组装请求消息，并发送处理请求消息。
QPS限流时如何增加QPS配额 问题现象 调用人脸识别API时，报错“FRS.0033”。 该报错表示您当前请求数太多，超过流控限制。 解决方法 建议控制请求策略或者进行重试。 增加QPS配额。 请参考人脸识别价格详情，按照您的需求增加QPS配额。 变更QPS规格。 登录人脸识别管理控制台。
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 Token认证：通过Token认证通用请求。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key)加密调用请求。 Token认证 需要使用同一个Token鉴权时，可以缓存起来，避免频繁调用。
为什么人脸识别通过率低 问题现象 人脸识别出现通过率低，前端需要抓拍多张才能找到阈值（0.93）以上的结果。 问题原因 底库照片质量不好。 前端抓拍条件很差。 前端抓拍到的人脸姿态跟底库照片的姿态相差较多，或者底库照片与抓拍的人像相差太多。 解决方案 重新录入底库的照片，将质量差的底库照片更换。
VideoDetectResult 功能介绍 视频活体检测结果结构体。 参数说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64。 actions List 动作列表。详细参数请参见表
如何处理未经授权的情况 提交OBS的数据到人脸识别服务进行识别，返回未经授权：The OBS is unauthorized时，您可以通过如下步骤处理： 使用OBS中的数据时，需要授权人脸识别服务能读取OBS数据，检查是否已在人脸识别服务的管理控制台单击过“委托授权”： 如果已经授权，界面将显示为“已授权”。
获取项目ID/账号名 从控制台获取项目ID/账号名 登录管理控制台。 鼠标移动至用户名，在下拉列表中单击“我的凭证”。 在“我的凭证”页面，可以查看用户名、账号名，在项目列表中查看项目ID。 图1 查看项目ID 调用API获取项目ID 项目ID还可以通过调用查询指定条件下的项目信息API获取。
构造请求 本节介绍REST API请求的组成，并以调用人脸检测为例说明如何调用API，您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。 请求URI 请求URI由如下部分组成。 {URI-scheme}
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
