检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
当图片中有多个人脸时,会检测其中最大的人脸是否为活体。新老用户均可用该接口。 前提条件: 请确保您已开通人脸识别服务,具体操作方法请参见申请服务。 约束限制: 只支持识别JPG、PNG、JPEG、BMP格式的图片。 application/json请求的body中,请使用标准Json格式。
返回结果 请求发送以后,您会收到响应,包含:状态码、响应消息头和响应消息体。 状态码 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于获取用户Token接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对
构造请求 本节介绍REST API请求的组成,并以调用人脸检测为例说明如何调用API,您还可以通过这个视频教程了解如何构造请求调用API:https://bbs.huaweicloud.com/videos/102987。 请求URI 请求URI由如下部分组成。 {URI-scheme}
HTTPS 人脸识别API 华东-上海一 cn-east-3 face.cn-east-3.myhuaweicloud.com HTTPS 人脸识别API 华南-广州 cn-south-1 face.cn-south-1.myhuaweicloud.com HTTPS 人脸识别API 父主题:
sort语法 json array形式,排序只支持数值类型,字段重复定义会被覆盖。 例1:单个排序字段 "sort":[ { "location": "desc" } ] 例2:多个排序字段 "sort": [
基本概念 账号 用户注册华为云时的账号,账号对其所拥有的资源及云服务具有完全的访问权限,可以重置用户密码、分配用户权限等。由于账号是付费主体,为了确保账号安全,建议您不要直接使用账号进行日常管理工作,而是创建用户并使用他们进行日常管理工作。 用户 由账号在IAM中创建的用户,是云
获取AK/SK 登录人脸识别管理控制台。 单击页面右上角的用户名,并选择“我的凭证”。 进入“我的凭证”页面。 单击“访问秘钥”页签下的“新增访问密钥”。 弹出“新增访问密钥”对话框。 输入“登录密码”,如果绑定了手机或者邮箱,还需要获取验证码并进行验证。 验证成功后,弹出访问密钥下载对话框。
LivelessDetectResult 功能介绍 静默活体检测结果结构体。 结构格式说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64字符串。 confidence Double
coding:utf-8 -*- import requests import base64 endpoint = '开通服务所在region的人脸识别服务域名' project_id = '开通服务所在region的用户项目ID' token = '用户获取得到的实际token值' headers
填写待检测图片数据。 输入数据image_file为本地文件。attributes为希望检测的人脸属性,如胡须、发型、表情等。 单击“调试”按钮,获取识别结果。 父主题: 调用API或SDK
调用API或SDK 在线调试 本地调用
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 Token认证:通过Token认证通用请求。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。 Token认证 需要使用同一个Token鉴权时,可以缓存起来,避免频繁调用。
人脸库资源管理 创建人脸库 查询所有人脸库 查询人脸库 删除人脸库 父主题: API
FRS自定义策略 如果系统预置的权限,不满足您的授权要求,可以创建自定义策略。自定义策略中可以添加的授权项(Action)请参见权限管理。 目前华为云支持以下两种方式创建自定义策略: 可视化视图创建自定义策略:无需了解策略语法,按可视化视图导航栏选择云服务、操作、资源、条件等策略内容,可自动生成策略。
用户登录并验证权限 使用新创建的IAM账户登录FRS控制台,切换至授权区域,进行验证权限。 进入FRS控制台界面,单击“开通服务”,如果无法开通,提示权限不足(假设主账户只为子用户开通了FRS ReadOnlyAccess只读权限),表示“FRS ReadOnlyAccess”已生效。
filter语法 数值类型 数值类型的范围查询,[]包含两端点值,{}不包含两端点值。 rowkey:[1 TO *] 大于等于1 rowkey:[* TO 1] 小于等于1 rowkey:[1 TO 10] 1到10 Request Body示例: {
如何查看API的使用量 登录人脸识别管理控制台。 在左侧导航栏中选择“云上服务管理”,查看API的使用量。 父主题: API使用类
使用FRS服务需要的权限 使用FRS服务无需权限配置,在管理控制台开通服务后即可使用。 使用FRS服务时,如果您需要使用华为云对象存储服务(OBS)中的数据,请开通对象存储服务OBS授权,可在控制台进行开通。 FRS服务支持IAM细粒度划分策略。 父主题: 权限类
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 人脸没有朝向前方。