检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
状态码 表1 状态码 状态码 编码 说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如，切换到HTTP的新版本协议。 200
计费说明 计费项 表1 计费项信息 计费项 计费说明 人脸识别接口调用次数 调用人脸识别的接口收费，提供按调用次数按需计费的方式。 计费模式 按需计费 按照API调用次数计费，按月累计，一个自然月后次数清零重新累计。 促销活动期间，每个用户每月前2000次免费（动作活体检测、静默
如何在含有多张人脸的图片中实现多人脸识别 当前人脸识别服务中，如果传入的图片中包含多个人脸，则只能选取最大的一个人脸进行识别。但是可以使用如下方法，实现一张图片中多张人脸的识别（比对/搜索）： 调用人脸检测接口，可以得到多张人脸在图片中的像素位置。 通过获取到的人脸位置信息，从原
避免频繁调用。 关于Token有效期的详细说明请参见获取IAM用户Token（使用密码）。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。
云审计服务 人脸识别使用云审计服务（Cloud Trace Service，以下简称CTS）记录人脸识别相关的操作事件，便于日后的查询、审计和回溯，具体如表1所示。云审计服务的更多信息请参见《云审计服务用户指南》。 表1 云审计服务支持的人脸识别操作列表 操作名称 资源类型 事件名称 创建人脸库
用户需要先在管理控制台开通人脸识别服务，使用第三方系统调用API即可使用服务，具体流程如下： 申请服务 在使用服务之前，您需要先登录人脸识别管理控制台开通服务，服务开通一次即可，后续使用时无需再开通。 在使用人脸识别服务时需要对OBS的数据进行操作，因此需要先同意服务授权：在开通服务界面，单击右上角“服务授权”，完成OBS授权操作。
et_name}/faces 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参见获取项目ID/账号名/AK/SK。 face_set_name 是 String 人脸库名称。 请求参数 表2 请求Header参数 参数
注册服务时，没有将OBS权限授予FRS服务。 解决方案 图片的路径按照“/bucket/image-path”格式，不需要带上域名。 人脸服务只能访问当前账号的OBS桶。 账号需要将OBS权限授予人脸服务，人脸服务才能访问OBS上的图片。 父主题： API使用类
状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 表1 公共响应消息头 消息头名称 说明
调用API报错FRS.0020怎么办 问题现象 在调用人脸识别接口时，报错“FRS.0020”，子服务未开通。 该报错表示您的子服务没有开通。 产生该报错的原因有以下两种： API没有开通，就直接调用，导致报错。 开通的API与实际调用的不一致，导致报错。 解决方法 如未开通服务
警告信息列表，warning-list数据结构请见WarningList。 调用失败时无此字段。 表5 video-result 参数 参数类型 描述 alive Boolean 是否是活体。 actions Array of ActionsList objects 动作列表。 picture
在欧洲地区有业务的用户，可以选择“欧洲-巴黎”区域。 云服务之间的关系 如果多个云服务一起搭配使用，需要注意： 不同区域的弹性云服务器、关系型数据库、对象存储服务内网不互通。 不同区域的弹性云服务器不支持跨区域部署在同一负载均衡器下。 资源的价格 不同区域的资源价格可能有差异，请参见华为云服务价格详情。
face_id={face_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参见获取项目ID/账号名/AK/SK。 face_set_name String 是 人脸库名称。 表2 Query参数 参数 是否必选 参数类型
错误码 调用API出错后，将不会返回结果数据。调用方可根据每个API对应的错误码来定位错误原因。当调用出错时，HTTP请求返回一个4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系客服，并提供错误码，以便我们尽快帮您解决问题。
Base64编码后大小不超过8MB，建议。 图片为JPG/JPEG/BMP/PNG格式。 similarity Double 人脸相似度，1表示最大，0表示最小，值越大表示越相似。一般情况下超过0.93即可认为是同一个人。 face_set_name String 人脸库名称，1位到64位之间，
结构格式说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64字符串。 confidence Double 系统对检测对象是否为活体的判定置信程度，取值范围为0到1。置信度越高，表示系统越确
视频活体检测结果结构体。 参数说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64。 actions List 动作列表。详细参数请参见表 字段要素说明。 表2 actions字段要素说明
高频报错处理办法 操作场景 本节内容介绍了调用API时，常见的报错及处理办法。 表1 调用API高频报错处理办法 常见报错 处理办法 FRS.0020子服务未开通 开通该服务，检查开通服务的区域（或账号）与调用服务的区域（或账号）是否一致，检查API的URL是否拼写正确。 APIG
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。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
