检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
调用说明 人脸识别服务提供了RESTful API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题： 使用前必读
project_id 是 String 项目ID，获取方法请参见获取项目ID/账号名/AK/SK。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见认证鉴权。 Content-Type
project_id 是 String 项目ID，获取方法请参见获取项目ID/账号名/AK/SK。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见认证鉴权。 Content-Type
project_id 是 String 项目ID，获取方法请参见获取项目ID/账号名/AK/SK。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见认证鉴权。 Content-Type
set_name}/faces 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参见获取项目ID/账号名/AK/SK。 face_set_name 是 String 人脸库名称，字符串长度1-64。 请求参数 表2 请求Header参数
project_id 是 String 项目ID，获取方法请参见获取项目ID/账号名/AK/SK。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见认证鉴权。 Content-Type
et_name}/search 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参见获取项目ID/账号名/AK/SK。 face_set_name 是 String 人脸库名称，字符串长度1-64。 请求参数 表2 请求Header参数
附录 状态码 错误码 获取项目ID/账号名/AK/SK
涉及到的所有参数类型的详细说明。 参数说明 表1 结果格式说明表 名称 类型 说明 project_id String 项目ID，获取方法请参见获取项目ID/账号名/AK/SK。 image_url String 图片的URL路径，目前仅支持华为云上OBS的URL，且人脸识别服务
产品咨询类 如何在含有多张人脸的图片中实现多人脸识别 人脸识别是否可使用证件类照片 如何处理未经授权的情况 为什么会出现识别错误的情况 为什么人脸识别通过率低 为什么会请求响应过慢 人脸检测接口可以免费调多少次 如何关闭已申请的服务 调用静默活体检测API，为什么在服务管理页面看不到调用量
在使用人脸识别服务时需要对OBS的数据进行操作，因此需要先同意服务授权：在开通服务界面，单击右上角“服务授权”，完成OBS授权操作。 获取请求认证 调用人脸识别的API有如下两种认证方式，请任选其中一种进行认证鉴权，鉴权详情请参见《认证鉴权》。 Token认证：通过Token认证调用请求。
访问秘钥”页面，获取Access Key（AK）和Secret Access Key（SK）。 图1 获取AK、SK 登录“我的凭证”页面，获取“IAM用户名”、“账号名”以及待使用区域的“项目ID”。调用服务时会用到这些信息，请提前保存。 本样例以“华北-北京四”区域为例，获取对应的项目ID（project_id）。
于15°、图片中人脸保持竖置正脸。 动作活体检测 目前支持检测视频文件，或视频的Base64编码，不支持直接检测视频流，需要用户客户端自己获取视频流并保存成文件，然后调用活体检测接口。 视频文件大小不超过8MB，建议客户端压缩到200KB~2MB。 限制视频时长1～15秒。 建议帧率10fps～30fps。
于15°、图片中人脸保持竖置正脸。 动作活体检测 目前支持检测视频文件，或视频的Base64编码，不支持直接检测视频流，需要用户客户端自己获取视频流并保存成文件，然后调用活体检测接口。 视频文件大小不超过8MB，建议客户端压缩到200KB~2MB。 限制视频时长1～15秒。 建议帧率10fps～30fps。
为什么会请求响应过慢 问题现象 用户发送https请求，需要经过tcp握手以及https证书交换，这个过程如果出现丢包情况，操作系统会进行数据包重传，重传间隔根据系统不同可能会3s或者5s。 解决方案 使用https长连接的方式进行请求，这样不必要每次请求都进行http建连。考虑
通过OBS方式传入图片报错FRS.0022怎么办 问题原因 OBS路径错误。 OBS桶并不是当前用户的桶。 注册服务时，没有将OBS权限授予FRS服务。 解决方案 图片的路径按照“/bucket/image-path”格式，不需要带上域名。 人脸服务只能访问当前账号的OBS桶。
终端节点 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 人脸识别服务的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点（Endpoint）
10QPS。当默认QPS无法满足您的业务需求时，可修改QPS配额，具体计费价格请参见人脸识别价格详情，增加QPS配额方法请参见QPS限流时如何增加QPS配额。 生效规则： 套餐包购买后大约5分钟内生效。 调用人脸识别API需在QPS套餐包生效期内调用。 已购买QPS套餐包支持退订，支持变更QPS配额。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
