检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
获取Token Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。 下载地址：FRS-API.postman_collection.json
用户登录并验证权限 使用新创建的IAM账户登录FRS控制台，切换至授权区域，进行验证权限。 进入FRS控制台界面，单击“开通服务”，如果无法开通，提示权限不足（假设主账户只为子用户开通了FRS ReadOnlyAccess只读权限），表示“FRS ReadOnlyAccess”已生效
filter语法 数值类型 数值类型的范围查询，[]包含两端点值，{}不包含两端点值。 rowkey:[1 TO *] 大于等于1 rowkey:[* TO 1] 小于等于1 rowkey:[1 TO 10] 1到10 Request Body示例： {
获取Token报错 获取Token时，请依据报错信息，选择相应的解决方案。 账密报错The username or password is wrong 返回The userInfo is wrong 请正确填写username和domainname，一般情况下，username=domainname
删除人脸 功能介绍 根据指定字段删除人脸库中人脸，删除后人脸库容量会相应的释放。 前提条件： 请确保您已开通人脸搜索服务。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI
为子用户分配权限 为子用户分配权限，子用户自行开通FRS服务 使用主账号登录IAM服务控制台。 打开用户组列表，找到子用户所在的用户组，单击该用户组的“授权”操作。 勾选需要授予用户组的权限，单击“确定”，完成用户组授权。FRS全部系统权限请参见权限管理。 当现有策略不满足时，可使用
终端节点 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 人脸识别服务的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点（Endpoint
查询人脸 功能介绍 查询指定人脸库中人脸信息。 前提条件： 请确保您已开通人脸搜索服务。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v2/{project_id
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 人脸没有朝向前方
更新人脸 功能介绍 根据人脸ID（face_id）更新单张人脸信息。 前提条件： 请确保您已开通人脸搜索服务。 application/json请求的body中，请使用标准Json格式。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer
为什么会请求响应过慢 问题现象 用户发送https请求，需要经过tcp握手以及https证书交换，这个过程如果出现丢包情况，操作系统会进行数据包重传，重传间隔根据系统不同可能会3s或者5s。 解决方案 使用https长连接的方式进行请求，这样不必要每次请求都进行http建连。考虑到
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为内置字段
image_url String 图片的URL路径，目前仅支持华为云上OBS的URL，且人脸识别服务有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 image_file File 本地图片文件，图片不能超过8MB，建议小于1MB。
DetectFace 功能介绍 人脸检测以及人脸比对返回的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 landmark Landmark
SearchFace 功能介绍 人脸搜索返回的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸
BoundingBox 功能介绍 人脸在图像中的位置，坐标系的原点（0,0）在左上角。 参数说明 表1 结构格式说明表 名称 类型 说明 top_left_x Integer 矩形框左上角横坐标。 top_left_y Integer 矩形框左上角纵坐标。 width Integer
表3 请求Body参数 参数名 参数类型 是否必选 说明 image_url String 与image_file、image_base64三选一 图片的URL路径，目前仅支持华为云上OBS的URL，使用时只需保证FRS有权限读取该OBS桶的数据。
批量删除人脸 功能介绍 自定义筛选条件，批量删除人脸库中的符合指定条件的多张人脸。 前提条件： 请确保您已开通人脸搜索服务。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
