华为人脸识别
华为人脸识别连接器基于华为云人脸识别服务集成开发,包含“人脸检测”、“人脸比对”、“人脸搜索”和“活体检测”等执行动作。
执行动作 |
使用说明 |
---|---|
人脸检测 |
人脸检测是对输入图片进行人脸检测和分析,输出人脸在图像中的位置、人脸关键属性。如果照片中存在多张人脸,则返回所有符合条件的人脸特征信息。 |
人脸比对 |
人脸比对是将两个人脸进行比对,来判断是否为同一个人,返回比对置信度。如果传入的图片中包含多个人脸,选取最大的人脸进行比对。 |
动作活体检测 |
动作活体检测是通过判断视频中的人物动作与传入动作列表是否一致来识别视频中人物是否为活体。如果有多张人脸出现,则选取最大的人脸进行判定。新老用户均可用该接口。 |
静默活体检测 |
静默活体检测是基于人脸图片中可能存在的畸变、摩尔纹、反光、倒影、边框等信息,判断图片中的人脸是否来自于真人活体,有效抵御纸质翻拍照、电子翻拍照以及视频翻拍等各种攻击方式。静默活体检测支持单张图片,不支持多人脸图片。新老用户均可用该接口。 |
人脸搜索 |
人脸搜索是指在已有的人脸库中,查询与目标人脸相似的一张或者多张人脸,并返回相应的置信度。如果图片中包含多个人脸,选取图片中检测到的最大尺寸人脸作为检索的输入。 |
创建人脸库 |
创建用于存储人脸特征的人脸库。您最多可以创建10个人脸库,每个人脸库最大容量为10万个人脸特征。 |
查询所有人脸库 |
查询当前用户所有人脸库的状态信息。 |
查询人脸库 |
查询人脸库当前的状态。 |
删除人脸库 |
删除人脸库以及其中所有的人脸。人脸库数据为用户隐私数据,该数据无备份,删除时请谨慎操作。 |
添加人脸 |
添加人脸到人脸库中。将单张图片中的人脸添加至人脸库中,支持添加最大人脸或所有人脸。 |
查询人脸 |
查询指定人脸库中人脸信息。 |
更新人脸 |
根据人脸ID(face_id)更新单张人脸信息。 |
删除人脸 |
根据指定字段删除人脸库中人脸,删除后人脸库容量会相应的释放。 |
批量删除人脸 |
自定义筛选条件,批量删除人脸库中的符合指定条件的多张人脸。 |
连接参数
华为人脸识别连接器使用IAM认证,连接参数说明如表2所示。
名称 |
必填 |
说明 |
示例值/默认值 |
---|---|---|---|
连接名称 |
是 |
设置连接名称。 |
华为人脸识别的连接 |
描述 |
否 |
对于连接的信息描述说明。 |
description |
租户名 |
是 |
IAM用户所属账号信息。了解账号与IAM用户的关系。 |
domain |
用户名 |
是 |
IAM用户名。 |
name |
密码 |
是 |
IAM用户的登录密码。 |
- |
项目ID |
是 |
系统为用户自动生成的项目ID,单击“我的凭证 > API凭证”,根据项目获取。 |
e9993fc787************a340f9c0f4 |
站点 |
是 |
站点。 |
iam.cn-north-4.myhuaweicloud.com |
人脸检测
人脸检测是对输入图片进行人脸检测和分析,输出人脸在图像中的位置、人脸关键属性。如果照片中存在多张人脸,则返回所有符合条件的人脸特征信息。
接口功能及调用方法请参考人脸检测。
- 输入参数
用户配置人脸检测执行动作,相关参数说明如表3所示。
表3 人脸检测输入参数说明 参数
说明
图片的URL路径
图片的URL路径,当前仅支持OBS路径。例:https://eventobas.obs.cn-north-4.myhuaweicloud.com/人像.png
(构成:https://BucketName.obs.example.com/ObjectName)
图像数据
图像数据,Base64编码,要求:Base64编码后大小不超过8MB,建议小于1MB。图片为JPG/JPEG/BMP/PNG格式。
希望返回的人脸属性
多个属性间使用逗号(,)隔开。目前支持的属性有: 2:年龄 4:装束(帽子、眼镜) 6:口罩 7:发型 8:胡须 11:图片类型 12:质量 13:表情 21:人脸图片旋转角(顺时针偏转角度),支持0°、90°、180°和270°图片旋转。
- 输出参数
用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表4。
表4 人脸检测输出参数说明 参数
说明
检测到的人脸集合
检测到的人脸。 调用失败时无此字段。
年龄
检测出的人脸年龄。
人脸质量得分
人脸质量总分,取值范围[0-1],分值越大质量越高。
模糊程度
模糊度,取值范围[0-1],分值越大模糊问题越严重。
姿态合规程度
姿态,取值范围[0-1],分值越大姿态问题越严重。
遮挡程度
遮挡,取值范围[0-1],分值越大遮挡问题越严重。
光照程度
光照,取值范围[0-1],分值越大光照问题越严重。
人脸表情类型
人脸表情类型:
- neutral:中性
- happy:高兴
- fear:害怕
- surprise:惊讶
- sad:伤心
- angry:生气
- disgust:厌恶
- unknown:图片质量问题导致未识别
表情置信度
表情置信度,取值范围[0-1]。
错误码
调用失败时的错误码,调用成功时无此字段。
错误信息
调用失败时的错误信息,调用成功时无此字段。
人脸比对
人脸比对是将两个人脸进行比对,来判断是否为同一个人,返回比对置信度。如果传入的图片中包含多个人脸,选取最大的人脸进行比对。具体参考:
接口功能及调用方法请参考人脸比对。
- 输入参数
用户配置人脸比对执行动作,相关参数说明如表5所示。
- 输出参数
用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表6。
动作活体检测
动作活体检测是通过判断视频中的人物动作与传入动作列表是否一致来识别视频中人物是否为活体。如果有多张人脸出现,则选取最大的人脸进行判定。新老用户均可用该接口。
接口功能及调用方法请参考活体检测。
- 输入参数
用户配置动作活体检测执行动作,相关参数说明如表7所示。
- 输出参数
用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表8。
静默活体检测
静默活体检测是基于人脸图片中可能存在的畸变、摩尔纹、反光、倒影、边框等信息,判断图片中的人脸是否来自于真人活体,有效抵御纸质翻拍照、电子翻拍照以及视频翻拍等各种攻击方式。静默活体检测支持单张图片,不支持多人脸图片。新老用户均可用该接口。
接口功能及调用方法请参考活体检测。
- 输入参数
用户配置静默活体检测执行动作,相关参数说明如表9所示。
- 输出参数
用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表10。
人脸搜索
人脸搜索是指在已有的人脸库中,查询与目标人脸相似的一张或者多张人脸,并返回相应的置信度。如果图片中包含多个人脸,选取图片中检测到的最大尺寸人脸作为检索的输入。
接口功能及调用方法请参考人脸搜索。
- 输入参数
用户配置人脸搜索执行动作,相关参数说明如表11所示。
- 输出参数
用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表12。
- 输出参数
用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表14。
- 输出参数
用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表15。
查询人脸库
查询人脸库当前的状态。
- 输入参数
用户配置查询人脸库执行动作,相关参数说明如表16所示。
- 输出参数
用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表17。
- 输出参数
用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表19。
添加人脸
添加人脸到人脸库中。将单张图片中的人脸添加至人脸库中,支持添加最大人脸或所有人脸。
- 输入参数
用户配置添加人脸执行动作,相关参数说明如表20所示。
- 输出参数
用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表21。
- 输出参数
用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表23。
- 输出参数
用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表25。
删除人脸
根据指定字段删除人脸库中人脸,删除后人脸库容量会相应的释放。
- 输入参数
用户配置删除人脸执行动作,相关参数说明如表26所示。
表26 删除人脸输入参数说明 参数
必填
说明
人脸库名称
是
人脸库的名称。
按条件删除的字段名
是
按条件删除的字段名,支持固定字段(external_image_id和face_id),以及用户的自定义字段(不支持空字符串和null值删除)。
- 输出参数
用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表27。
批量删除人脸
自定义筛选条件,批量删除人脸库中的符合指定条件的多张人脸。
- 输入参数
用户配置批量删除人脸执行动作,相关参数说明如表28所示。
- 输出参数
用户可以在之后的执行动作中调用该输出参数,输出参数说明请参考表29。