# 华为人脸识别 华为人脸识别连接器基于华为云人脸识别服务集成开发，包含"人脸检测"、"人脸比对"、"人脸搜索"和"活体检测"等执行动作。 表1华为人脸识别连接器 | 执行动作 | 使用说明 | |:---|:---| | 人脸检测 | 人脸检测是对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。如果照片中存在多张人脸，则返回所有符合条件的人脸特征信息。 | | 人脸比对 | 人脸比对是将两个人脸进行比对，来判断是否为同一个人，返回比对置信度。如果传入的图片中包含多个人脸，选取最大的人脸进行比对。 | | 动作活体检测 | 动作活体检测是通过判断视频中的人物动作与传入动作列表是否一致来识别视频中人物是否为活体。如果有多张人脸出现，则选取最大的人脸进行判定。新老用户均可用该接口。 | | 静默活体检测 | 静默活体检测是基于人脸图片中可能存在的畸变、摩尔纹、反光、倒影、边框等信息，判断图片中的人脸是否来自于真人活体，有效抵御纸质翻拍照、电子翻拍照以及视频翻拍等各种攻击方式。静默活体检测支持单张图片，不支持多人脸图片。新老用户均可用该接口。 | | 人脸搜索 | 人脸搜索是指在已有的人脸库中，查询与目标人脸相似的一张或者多张人脸，并返回相应的置信度。如果图片中包含多个人脸，选取图片中检测到的最大尺寸人脸作为检索的输入。 | | 创建人脸库 | 创建用于存储人脸特征的人脸库。您最多可以创建10个人脸库，每个人脸库最大容量为10万个人脸特征。 | | 查询所有人脸库 | 查询当前用户所有人脸库的状态信息。 | | 查询人脸库 | 查询人脸库当前的状态。 | | 删除人脸库 | 删除人脸库以及其中所有的人脸。人脸库数据为用户隐私数据，该数据无备份，删除时请谨慎操作。 | | 添加人脸 | 添加人脸到人脸库中。将单张图片中的人脸添加至人脸库中，支持添加最大人脸或所有人脸。 | | 查询人脸 | 查询指定人脸库中人脸信息。 | | 更新人脸 | 根据人脸ID（face_id）更新单张人脸信息。 | | 删除人脸 | 根据指定字段删除人脸库中人脸，删除后人脸库容量会相应地释放。 | | 批量删除人脸 | 自定义筛选条件，批量删除人脸库中的符合指定条件的多张人脸。 | #### 连接参数 华为人脸识别连接器使用IAM认证，连接参数说明如[表2]所示。 表2连接参数说明 | 名称 | 必填 | 说明 | 示例值/默认值 | |:---|:---|:---|:---| | 连接名称 | 是 | 设置连接名称。 | 华为人脸识别的连接 | | 描述 | 否 | 对于连接的信息描述说明。 | description | | 租户名 | 是 | IAM用户所属账号信息。了解[账号与IAM用户的关系](https://support.huaweicloud.com/productdesc-iam/iam_01_0023.html#section2)。 | domain | | 用户名 | 是 | IAM用户名。 | name | | 密码 | 是 | IAM用户的登录密码。 | - | | 项目ID | 是 | 系统为用户自动生成的项目ID，单击"我的凭证 \> API凭证"，根据项目获取。 | e9993fc787\*\*\*\*\*\*\*\*\*\*\*\*a340f9c0f4 | | 站点 | 是 | 站点。 | iam.cn-north-4.myhuaweicloud.com | #### 人脸检测 人脸检测是对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。如果照片中存在多张人脸，则返回所有符合条件的人脸特征信息。 接口功能及调用方法请参考[人脸检测](https://support.huaweicloud.com/api-face/face_02_0084.html)。 - 输入参数 用户配置人脸检测执行动作，相关参数说明如[表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\]。 | | 错误码 | 调用失败时的错误码，调用成功时无此字段。 | | 错误信息 | 调用失败时的错误信息，调用成功时无此字段。 | #### 人脸比对 人脸比对是将两个人脸进行比对，来判断是否为同一个人，返回比对置信度。如果传入的图片中包含多个人脸，选取最大的人脸进行比对。具体参考： 接口功能及调用方法请参考[人脸比对](https://support.huaweicloud.com/api-face/face_02_0085.html)。 - 输入参数 用户配置人脸比对执行动作，相关参数说明如[表5]所示。 表5人脸比对输入参数说明 | 参数 | 说明 | |:---|:---| | 图片1的URL路径 | 图片的URL路径，当前仅支持OBS路径。 | | 图像数据1 | 图像数据，Base64编码，要求：Base64编码后大小不超过8MB，建议小于1MB。图片为JPG/JPEG/BMP/PNG格式。 | | 图片1的URL路径 | 图片的URL路径，当前仅支持OBS路径。 | | 图像数据2 | 图像数据，Base64编码，要求：Base64编码后大小不超过8MB，建议小于1MB。图片为JPG/JPEG/BMP/PNG格式。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表6]。 表6人脸比对输出参数说明 | 参数 | 说明 | |:---|:---| | 人脸相似度 | 人脸相似度，1表示最大，0表示最小，值越大表示越相似。 | | 错误码 | 调用失败时的错误码，调用成功时无此字段。 | | 错误信息 | 调用失败时的错误信息，调用成功时无此字段。 | #### 动作活体检测 动作活体检测是通过判断视频中的人物动作与传入动作列表是否一致来识别视频中人物是否为活体。如果有多张人脸出现，则选取最大的人脸进行判定。新老用户均可用该接口。 接口功能及调用方法请参考[活体检测](https://support.huaweicloud.com/api-face/face_02_0101.html)。 - 输入参数 用户配置动作活体检测执行动作，相关参数说明如[表7]所示。 表7动作活体检测输入参数说明 | 参数 | 必填 | 说明 | |:---|:---|:---| | 视频的URL路径 | 否 | 视频的URL路径，目前仅支持OBS的URL。 | | 动作顺序 | 是 | 动作代码顺序列表，英文逗号（,）分隔。有输入框或者下拉框输入方式。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表8]。 表8动作活体检测输出参数说明 | 参数 | 说明 | |:---|:---| | 活体检测结果 | 是否是活体。 | | 动作列表 | 动作列表。 | | 动作顺序编号 | 动作编号，取值范围：\[1,2,3,4\]，其中： 1：左摇头 2：右摇头 3：点头 4：嘴部动作。 | | 置信度 | 置信度，取值范围0～1。 | | 检测人脸结果图片 | 检测出最大人脸的图片base64。 | | 警告信息 | 警告信息列表。 | | 警告ID | 警告ID。 | | 告警消息 | 告警消息。 | | 错误码 | 调用失败时的错误码，调用成功时无此字段。 | | 错误信息 | 调用失败时的错误信息，调用成功时无此字段。 | #### 静默活体检测 静默活体检测是基于人脸图片中可能存在的畸变、摩尔纹、反光、倒影、边框等信息，判断图片中的人脸是否来自于真人活体，有效抵御纸质翻拍照、电子翻拍照以及视频翻拍等各种攻击方式。静默活体检测支持单张图片，不支持多人脸图片。新老用户均可用该接口。 接口功能及调用方法请参考[活体检测](https://support.huaweicloud.com/api-face/face_02_0101.html)。 - 输入参数 用户配置静默活体检测执行动作，相关参数说明如[表9]所示。 表9静默活体检测输入参数说明 | 参数 | 必填 | 说明 | |:---|:---|:---| | 视频的URL路径 | 与图片文件，图像数据三选一 | 视频的URL路径，目前仅支持OBS的URL。 | | 图片文件 | 与视频的URL路径，图像数据三选一 | 本地图片文件，图片不能超过8MB，建议小于1MB。上传文件时，请求格式为multipart。 | | 图像数据 | 与视频的URL路径，图像数据三选一 | 图像数据，Base64编码，要求：Base64编码后大小不超过8MB，建议小于1MB。图片为JPG/JPEG/BMP/PNG格式。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表10]。 表10静默活体检测输出参数说明 | 参数 | 说明 | |:---|:---| | 活体检测结果 | 是否是活体。 | | 置信度 | 置信度，取值范围0～1。 | | 检测人脸结果图片 | 检测出最大人脸的图片base64。 | | 错误码 | 调用失败时的错误码，调用成功时无此字段。 | | 错误信息 | 调用失败时的错误信息，调用成功时无此字段。 | #### 人脸搜索 人脸搜索是指在已有的人脸库中，查询与目标人脸相似的一张或者多张人脸，并返回相应的置信度。如果图片中包含多个人脸，选取图片中检测到的最大尺寸人脸作为检索的输入。 接口功能及调用方法请参考[人脸搜索](https://support.huaweicloud.com/api-face/face_02_0086.html)。 - 输入参数 用户配置人脸搜索执行动作，相关参数说明如[表11]所示。 表11人脸搜索输入参数说明 | 参数 | 必填 | 说明 | |:---|:---|:---| | 人脸库名称 | 是 | 人脸库名称。 | | 人脸ID | 人脸ID，图片文件，图像数据三选一 | 导入人脸时，系统返回的人脸编号，即人脸ID。 | | 图片文件 | 人脸ID，图片文件，图像数据三选一 | 本地图片文件，图片不能超过8MB，建议小于1MB。上传文件时，请求格式为multipart。 | | 图像数据 | 人脸ID，图片文件，图像数据三选一 | 图像数据，Base64编码，要求：Base64编码后大小不超过8MB，建议小于1MB。图片为JPG/JPEG/BMP/PNG格式。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表12]。 表12人脸搜索输出参数说明 | 参数 | 说明 | |:---|:---| | 人脸集合 | 查找的人脸集合。 | | 相似度 | 人脸搜索时用于被检索的相似度。 | | 外部图片ID | 人脸所在的外部图片ID。 | | 人脸ID | 人脸ID，由系统内部生成的唯一ID。 | | 错误码 | 调用失败时的错误码，调用成功时无此字段。 | | 错误信息 | 调用失败时的错误信息，调用成功时无此字段。 | #### 创建人脸库 创建用于存储人脸特征的人脸库。您最多可以创建10个人脸库，每个人脸库最大容量为10万个人脸特征。 - 输入参数 用户配置创建人脸库执行动作，相关参数说明如[表13]所示。 表13创建人脸库输入参数说明 | 参数 | 必填 | 说明 | |:---|:---|:---| | 人脸库的名称 | 是 | 人脸库的名称。 | | 人脸库最大的容量 | 否 | 人脸库最大的容量，填写1万整数倍的数字，默认为100,000。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表14]。 表14创建人脸库输出参数说明 | 参数 | 说明 | |:---|:---| | 人脸库最大的容量 | 人脸库当中的人脸数量。 | | 人脸库ID | 人脸库ID，随机生成的包含八个字符的字符串。 | | 人脸库名称 | 人脸库名称。 | | 创建时间 | 创建时间。 | | 人脸库最大的容量 | 人脸库最大的容量。 | | 错误码 | 调用失败时的错误码，调用成功时无此字段。 | | 错误信息 | 调用失败时的错误信息，调用成功时无此字段。 | #### 查询所有人脸库 查询当前用户所有人脸库的状态信息。 - 输入参数 该执行动作无需输入参数。 - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表15]。 表15查询所有人脸库输出参数说明 | 参数 | 说明 | |:---|:---| | 人脸库信息集合 | 人脸库信息集合。 | | 人脸库当中的人脸数量 | 人脸库当中的人脸数量。 | | 人脸库ID | 人脸库ID，随机生成的包含八个字符的字符串。 | | 人脸库名称 | 人脸库名称。 | | 创建时间 | 创建时间。 | | 人脸库最大的容量 | 人脸库最大的容量。 | | 错误码 | 调用失败时的错误码，调用成功时无此字段。 | | 错误信息 | 调用失败时的错误信息，调用成功时无此字段。 | #### 查询人脸库 查询人脸库当前的状态。 - 输入参数 用户配置查询人脸库执行动作，相关参数说明如[表16]所示。 表16查询人脸库输入参数说明 | 参数 | 必填 | 说明 | |:---|:---|:---| | 人脸库名称 | 是 | 人脸库的名称。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表17]。 表17查询人脸库输出参数说明 | 参数 | 说明 | |:---|:---| | 人脸数量 | 人脸库当中的人脸数量。 | | 人脸库ID | 人脸库ID，随机生成的包含八个字符的字符串。 | | 人脸库名称 | 人脸库名称。 | | 创建时间 | 创建时间。 | | 人脸库最大的容量 | 人脸库最大的容量。 | | 错误码 | 调用失败时的错误码，调用成功时无此字段。 | | 错误信息 | 调用失败时的错误信息，调用成功时无此字段。 | #### 删除人脸库 删除人脸库以及其中所有的人脸。人脸库数据为用户隐私数据，该数据无备份，删除时请谨慎操作。 - 输入参数 用户配置删除人脸库执行动作，相关参数说明如[表18]所示。 表18删除人脸库输入参数说明 | 参数 | 必填 | 说明 | |:---|:---|:---| | 人脸库名称 | 是 | 人脸库的名称。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表19]。 表19删除人脸库输出参数说明 | 参数 | 说明 | |:---|:---| | 人脸库名称 | 人脸库的名称。 | | 错误码 | 调用失败时的错误码，调用成功时无此字段。 | | 错误信息 | 调用失败时的错误信息，调用成功时无此字段。 | #### 添加人脸 添加人脸到人脸库中。将单张图片中的人脸添加至人脸库中，支持添加最大人脸或所有人脸。 - 输入参数 用户配置添加人脸执行动作，相关参数说明如[表20]所示。 表20添加人脸输入参数说明 | 参数 | 必填 | 说明 | |:---|:---|:---| | 人脸库名称 | 是 | 人脸库的名称。 | | 视频的URL路径 | 与图片文件，图像数据三选一 | 视频的URL路径，目前仅支持OBS的URL。 | | 图片文件 | 与视频的URL路径，图像数据三选一 | 本地图片文件，图片不能超过8MB，建议小于1MB。上传文件时，请求格式为multipart。 | | 图像数据 | 与视频的URL路径，图像数据三选一 | 图像数据，Base64编码，要求：Base64编码后大小不超过8MB，建议小于1MB。图片为JPG/JPEG/BMP/PNG格式。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表21]。 表21添加人脸输出参数说明 | 参数 | 说明 | |:---|:---| | 人脸库ID | 人脸库ID，随机生成的包含八个字符的字符串。 | | 人脸库名称 | 人脸库的名称。 | | 人脸结构 | 人脸库当中的人脸结构。 | | 外部图片ID | 人脸所在的外部图片ID。 | | 人脸ID | 人脸ID，由系统内部生成的唯一ID。 | | 错误码 | 调用失败时的错误码，调用成功时无此字段。 | | 错误信息 | 调用失败时的错误信息，调用成功时无此字段。 | #### 查询人脸 查询指定人脸库中人脸信息。 - 输入参数 用户配置查询人脸执行动作，相关参数说明如[表22]所示。 表22查询人脸输入参数说明 | 参数 | 必填 | 说明 | |:---|:---|:---| | 人脸库名称 | 是 | 人脸库的名称。 | | 起始索引 | 否 | 从第几条数据读起，默认为0。 | | 读取条数 | 否 | 读取多少条，默认为5。 | | 人脸ID | 否 | 人脸ID。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表23]。 表23查询人脸输出参数说明 | 参数 | 说明 | |:---|:---| | 人脸库ID | 人脸库ID，随机生成的包含八个字符的字符串。 | | 人脸库名称 | 人脸库的名称。 | | 人脸结构 | 人脸库当中的人脸结构。 | | 外部图片ID | 人脸所在的外部图片ID。 | | 人脸ID | 人脸ID，由系统内部生成的唯一ID。 | | 错误码 | 调用失败时的错误码，调用成功时无此字段。 | | 错误信息 | 调用失败时的错误信息，调用成功时无此字段。 | #### 更新人脸 根据人脸ID（face_id）更新单张人脸信息。 - 输入参数 用户配置更新人脸执行动作，相关参数说明如[表24]所示。 表24更新人脸输入参数说明 | 参数 | 必填 | 说明 | |:---|:---|:---| | 人脸库名称 | 是 | 人脸库的名称。 | | 人脸ID | 是 | 人脸ID，由系统内部生成的唯一ID。 | | 外部图片ID | 是 | 用户指定的图片外部ID，与当前图像绑定。用户没提供，系统会生成一个。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表25]。 表25更新人脸输出参数说明 | 参数 | 说明 | |:---|:---| | 更新的人脸数量 | 更新的人脸数量。 调用失败时无此字段。 | | 人脸库ID | 人脸库ID，调用失败时无此字段。 | | 人脸库名称 | 人脸库的名称，调用失败时无此字段。 | | 错误码 | 调用失败时的错误码，调用成功时无此字段。 | | 错误信息 | 调用失败时的错误信息，调用成功时无此字段。 | #### 删除人脸 根据指定字段删除人脸库中人脸，删除后人脸库容量会相应地释放。 - 输入参数 用户配置删除人脸执行动作，相关参数说明如[表26]所示。 表26删除人脸输入参数说明 | 参数 | 必填 | 说明 | |:---|:---|:---| | 人脸库名称 | 是 | 人脸库的名称。 | | 按条件删除的字段名 | 是 | 按条件删除的字段名，支持固定字段（external_image_id和face_id），以及用户的[自定义字段](https://support.huaweicloud.com/api-face/face_02_0012.html)（不支持空字符串和null值删除）。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表27]。 表27删除人脸输出参数说明 | 参数 | 说明 | |:---|:---| | 删除的人脸数量 | 删除的人脸数量。 调用失败时无此字段。 | | 人脸库ID | 人脸库ID，调用失败时无此字段。 | | 人脸库名称 | 人脸库的名称，调用失败时无此字段。 | | 错误码 | 调用失败时的错误码，调用成功时无此字段。 | | 错误信息 | 调用失败时的错误信息，调用成功时无此字段。 | #### 批量删除人脸 自定义筛选条件，批量删除人脸库中的符合指定条件的多张人脸。 - 输入参数 用户配置批量删除人脸执行动作，相关参数说明如[表28]所示。 表28批量删除人脸输入参数说明 | 参数 | 必填 | 说明 | |:---|:---|:---| | 人脸库名称 | 是 | 人脸库的名称。 | | 过滤条件 | 是 | 过滤条件，具体参见[filter语法](https://support.huaweicloud.com/api-face/face_02_0014.html)。 | - 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表29]。 表29批量删除人脸输出参数说明 | 参数 | 说明 | |:---|:---| | 删除的人脸数量 | 删除的人脸数量。 调用失败时无此字段。 | | 人脸库ID | 人脸库ID，调用失败时无此字段。 | | 人脸库名称 | 人脸库的名称，调用失败时无此字段。 | | 错误码 | 调用失败时的错误码，调用成功时无此字段。 | | 错误信息 | 调用失败时的错误信息，调用成功时无此字段。 |