检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
公共数据结构 自定义字段 sort语法 filter语法 消息对象结构
调用说明 人脸识别服务提供了RESTful API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题： 使用前必读
操作场景 本节内容介绍了调用API时，常见的报错及处理办法。 表1 调用API高频报错处理办法 常见报错 处理办法 FRS.0020子服务未开通 开通该服务，检查开通服务的区域（或账号）与调用服务的区域（或账号）是否一致，检查API的URL是否拼写正确。 APIG.0101 检查请求地址或者URL是否填写正确。
sort语法 json array形式，排序只支持数值类型，字段重复定义会被覆盖。 例1：单个排序字段 "sort":[ { "location": "desc" } ] 例2：多个排序字段 "sort": [
约束与限制 受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可免费使用10个人脸库，每个人脸库容量为1
调用API或SDK 在线调试 本地调用
filter语法 数值类型 数值类型的范围查询，[]包含两端点值，{}不包含两端点值。 rowkey:[1 TO *] 大于等于1 rowkey:[* TO 1] 小于等于1 rowkey:[1 TO 10] 1到10 Request Body示例： {
在线调试 API Explorer在线调试工具提供API的检索、调试、代码示例生成功能。同时，集成开发环境CloudIDE，可完成代码的构建、调试、运行。 本章节以人脸检测为例，介绍如何使用API Explorer调试API。 前提条件 注册华为账号并开通华为云，并完成实名认证，
else { fmt.Println(err) } SDK代码自动生成 API Explorer提供API检索及平台调试，支持全量快速检索、可视化调试、帮助文档查看和在线咨询。 您只需要在API Explorer中修改接口参数，即可自动生成对应的代码示例。同时，可在集成开发
消息对象结构 AllParam DetectFace Landmark Attributes FaceQuality FaceExpression FaceSetFace SearchFace FaceSetInfo BoundingBox VideoDetectResult LivelessDetectResult
因权限造成的调用API失败 问题现象 子用户已经开通了人脸识别服务，但是调用时还是提示未订阅。 解决方法 确认调用API所用的区域，与开通服务区域是否一致。 需要核实主账户赋予的权限，并核实开通服务的子账户与调用API时使用的子账户是否相同。 父主题： 权限类
Attributes 功能介绍 人脸属性结构。 参数说明 表1 结构格式说明表 名称 类型 说明 age Integer 年龄。 dress List of strings 包含glass和hat两个属性结果。 glass String 是否戴眼镜： yes：戴眼镜 none：未戴眼镜
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
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 人脸没有朝向前方。
VideoDetectResult 功能介绍 视频活体检测结果结构体。 参数说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64。 actions List 动作列表。详细参数请参见表
FaceSetInfo 功能介绍 人脸库的基本信息。 参数说明 表1 结构格式说明表 名称 类型 说明 face_set_name String 人脸库名称。 face_set_id String 人脸库ID，随机生成的包含八个字符的字符串。 create_date String
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
