检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
前提条件： 请确保您已开通人脸搜索服务。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
前提条件： 请确保您已开通人脸搜索服务。 默认情况下，一个人脸库最大可支持10万个人脸特征，一个用户最多可创建10个人脸库，最多可支持10*10万（100万）个人脸特征。
top_n参数如何设置 为什么使用人脸识别返回数据为空 人脸识别所需最低带宽是多少 如何获取OBS桶内最近图片的地址URL 人脸识别上传的人脸图片还可以查询到图片数据吗 人脸搜索是否需要使用OBS服务 如何查看API的使用量
人脸搜索 人脸搜索 人脸搜索是指在已有的人脸库中，查询与目标人脸相似的一张或者多张人脸，并返回相应的置信度。 人脸库资源管理 创建人脸库 创建用于存储人脸特征的人脸库。您最多可以创建10个人脸库，每个人脸库最大容量为10万个人脸特征。如有更大规格的需求请联系客服。
为什么使用人脸识别返回数据为空？ 人脸搜索接口中关于top_n参数如何设置？ 通过OBS方式传入图片提示FRS.0022？ 为什么会出现识别错误的情况？ 为什么人脸识别通过率低？ 为什么会请求响应过慢？
人脸识别上传的人脸图片还可以查询到图片数据吗 人脸识别不存储客户人脸图片，只是根据客户的图片来检测人脸参数，只存储人脸特征。如果需要存储图片数据可参考以下方法： 可以开通华为云OBS，存储人脸图片。 人脸图片可以存储在客户自己的数据库中。 父主题： API使用类
人脸搜索错误码 （错误码区间：29～31） 400 FRS.0029 过滤格式错误。 请参考人脸搜索请求参数章节，检查输入格式是否合法。 400 FRS.0030 返回字段未定义。 请参考人脸搜索请求参数章节，检查return_fields是否定义。
人脸检测、人脸比对、人脸搜索 父主题： 使用前必读
图2 人脸比对示意图 人脸搜索 人脸搜索给用户提供了人脸集操作相关的API。
sort": [ { "timestamp": "desc" }, { "rowkey": "asc" } ] 父主题： 公共数据结构
offset Integer 从第几条数据读起，默认为0。 limit Integer 读取多少条，默认为5。 video_url String 视频的URL路径，目前仅支持华为云上OBS的URL，且人脸识别服务有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。
FaceQuality FaceExpression FaceSetFace SearchFace FaceSetInfo BoundingBox VideoDetectResult LivelessDetectResult ServiceInfo WarningList 父主题： 公共数据结构
表2 FRS操作与系统策略关系 Action Action说明 FRS FullAccess FRS ReadOnlyAccess frs:faceSearch:subscribe 订阅人脸搜索服务 √ × frs:faceSearch:unsubscribe 取消订阅人脸搜索服务
自定义字段 数据类型 支持String，Integer，Float，Double，Boolean，Long。
Attributes 功能介绍 人脸属性结构。 参数说明 表1 结构格式说明表 名称 类型 说明 age Integer 年龄。 dress List of strings 包含glass和hat两个属性结果。 glass String 是否戴眼镜： yes：戴眼镜 none：未戴眼镜
DetectFace 功能介绍 人脸检测以及人脸比对返回的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 landmark Landmark
BoundingBox 功能介绍 人脸在图像中的位置，坐标系的原点（0,0）在左上角。 参数说明 表1 结构格式说明表 名称 类型 说明 top_left_x Integer 矩形框左上角横坐标。 top_left_y Integer 矩形框左上角纵坐标。 width Integer
FaceQuality 功能介绍 人脸质量结构。 参数说明 表1 结构格式说明表 名称 类型 说明 total_score Double 人脸质量总分，取值范围[0-1]，分值越大质量越高。 blur Double 模糊度，取值范围[0-1]，分值越大模糊问题越严重。 pose Double
Landmark 功能介绍 人脸关键点结构。 参数说明 表1 结构格式说明表 名称 类型 说明 nose_contour List [Point] 鼻子轮廓，Point为轮廓坐标值。 mouth_contour List [Point] 嘴巴轮廓，Point为轮廓坐标值。 eyebrow_contour
WarningList 功能介绍 视频活体检测警告信息。 参数说明 表1 结构格式说明 名称 类型 说明 warningCode Integer 警告ID。 warningMsg String 警告消息。 表2 错误提示 warningCode warningMsg 1 人脸没有朝向前方
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
