检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
消息对象结构 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为内置字段，自定义字段避免使用。
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
ServiceInfo 功能介绍 记录子服务信息。 参数说明 表1 结构格式说明表 名称 类型 说明 subscribe_status Boolean 是否开通该子服务。 create_time String 开通该子服务时间。 父主题： 消息对象结构
因权限造成的调用API失败 问题现象 子用户已经开通了人脸识别服务，但是调用时还是提示未订阅。 解决方法 确认调用API所用的区域，与开通服务区域是否一致。 需要核实主账户赋予的权限，并核实开通服务的子账户与调用API时使用的子账户是否相同。 父主题： 权限类
VideoDetectResult 功能介绍 视频活体检测结果结构体。 参数说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64。 actions List 动作列表。详细参数请参见表
FaceSetInfo 功能介绍 人脸库的基本信息。 参数说明 表1 结构格式说明表 名称 类型 说明 face_set_name String 人脸库名称。 face_set_id String 人脸库ID，随机生成的包含八个字符的字符串。 create_date String
FaceExpression 功能介绍 人脸表情结构。 参数说明 表1 结构格式说明表 名称 类型 说明 type String 人脸表情类型 neutral：中性 happy：高兴 fear：害怕 surprise：惊讶 sad：伤心 angry：生气 disgust：厌恶 unknown：图片质量问题导致未识别
调用API报错时怎么处理 检查原因 根据API调用返回结果或者错误码查找原因。 检查访问密钥AK/SK是否获取成功。 检查Token是否填写正确或者已过期。 检查API调用方法是否正确。 参考视频指导 您可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud
LivelessDetectResult 功能介绍 静默活体检测结果结构体。 结构格式说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64字符串。 confidence Double
获取项目ID/账号名/AK/SK 获取项目ID/账号名 获取账号ID 获取AK/SK 父主题： 附录
FaceSetFace 功能介绍 人脸库当中的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸ID，由系统内部生成的唯一ID。
获取AK/SK 登录人脸识别管理控制台。 单击页面右上角的用户名，并选择“我的凭证”。 进入“我的凭证”页面。 单击“访问秘钥”页签下的“新增访问密钥”。 弹出“新增访问密钥”对话框。 输入“登录密码”，如果绑定了手机或者邮箱，还需要获取验证码并进行验证。 验证成功后，弹出访问密钥下载对话框。
OBS）中，您可以参考API文档“人脸库资源管理”和“人脸资源管理”相关章节，对人脸库和人脸资源进行管理。 开通人脸识别服务是否需要授权 由于应用可能需要使用对象存储服务（OBS）中的数据，人脸识别服务需要您授权可以操作对象存储服务。 调用人脸识别服务API不需要额外权限。 服务支持IAM服务细粒度划分策略。
上传的人脸图片要求：侧脸不超过30°，抬头低头不超过15°。 图片中人脸需要保持竖置正脸，如果人像是横置或倒置，可以选择旋转至竖置正脸后重试。 父主题： API使用类
人脸识别API 华东-上海一 cn-east-3 face.cn-east-3.myhuaweicloud.com HTTPS 人脸识别API 华南-广州 cn-south-1 face.cn-south-1.myhuaweicloud.com HTTPS 人脸识别API 父主题：
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
