检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
为什么使用人脸识别返回数据为空 问题现象 上传照片中的人像可能存在横置或倒置等情况。 解决方法 尽量选择纯色无干扰背景，保证图片中人像清晰。 上传的人脸图片要求：侧脸不超过30°，抬头低头不超过15°。 图片中人脸需要保持竖置正脸，如果人像是横置或倒置，可以选择旋转至竖置正脸后重试。
使用FRS服务，是否会保存用户数据 FRS服务坚持“华为云始终把可信作为产品质量的第一要素”的理念，我们基于安全、合规、隐私、韧性、透明，为您提供有技术、有未来、值得信赖的云服务。具体的声明请参考隐私政策声明和法律声明，可信资源请参见白皮书资源。关于人脸识别的相关声明请参见人脸识别服务声明。
FaceSetInfo 功能介绍 人脸库的基本信息。 参数说明 表1 结构格式说明表 名称 类型 说明 face_set_name String 人脸库名称。 face_set_id String 人脸库ID，随机生成的包含八个字符的字符串。 create_date String
FaceSetFace 功能介绍 人脸库当中的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸ID，由系统内部生成的唯一ID。
约束与限制 受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可使用10个人脸库，每个人脸库容量为10万
约束与限制 受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可免费使用10个人脸库，每个人脸库容量为1
添加人脸 功能介绍 添加人脸到人脸库中。将单张图片中的人脸添加至人脸库中，支持添加最大人脸或所有人脸。 前提条件： 请确保您已开通人脸搜索服务。 约束限制： 只支持识别JPG、PNG、JPEG、BMP格式的图片。 application/json请求的body中，请使用标准Json格式。
sort语法 json array形式，排序只支持数值类型，字段重复定义会被覆盖。 例1：单个排序字段 "sort":[ { "location": "desc" } ] 例2：多个排序字段 "sort": [
filter语法 数值类型 数值类型的范围查询，[]包含两端点值，{}不包含两端点值。 rowkey:[1 TO *] 大于等于1 rowkey:[* TO 1] 小于等于1 rowkey:[1 TO 10] 1到10 Request Body示例： {
消息对象结构 AllParam DetectFace Landmark Attributes FaceQuality FaceExpression FaceSetFace SearchFace FaceSetInfo BoundingBox VideoDetectResult LivelessDetectResult
Attributes 功能介绍 人脸属性结构。 参数说明 表1 结构格式说明表 名称 类型 说明 age Integer 年龄。 dress List of strings 包含glass和hat两个属性结果。 glass String 是否戴眼镜： yes：戴眼镜 none：未戴眼镜
自定义字段 数据类型 支持String，Integer，Float，Double，Boolean，Long。 external_image_id，bounding_box，similarity，face_id，create_time，vector，_id，_all，_source为内置字段，自定义字段避免使用。
AllParam 功能介绍 涉及到的所有参数类型的详细说明。 参数说明 表1 结果格式说明表 名称 类型 说明 project_id String 项目ID，获取方法请参见获取项目ID/账号名/AK/SK。 image_url String 图片的URL路径，目前仅支持华为云上O
DetectFace 功能介绍 人脸检测以及人脸比对返回的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 landmark Landmark
SearchFace 功能介绍 人脸搜索返回的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸ID，由系统内部生成的唯一ID。
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
VideoDetectResult 功能介绍 视频活体检测结果结构体。 参数说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64。 actions List 动作列表。详细参数请参见表
FaceExpression 功能介绍 人脸表情结构。 参数说明 表1 结构格式说明表 名称 类型 说明 type String 人脸表情类型 neutral：中性 happy：高兴 fear：害怕 surprise：惊讶 sad：伤心 angry：生气 disgust：厌恶 unknown：图片质量问题导致未识别
API概览 人脸识别服务所提供的API，均符合RESTful API设计规范，如表1所示。 表1 人脸识别API 类型 API 说明 人脸检测 人脸检测 人脸检测是对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。 人脸比对 人脸比对 人脸比对是将两个人脸进行比
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
