CompareFaceWithMask_视觉智能开放平台-人脸人体_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

功能描述

口罩人脸比对 1:1 能力基于您输入的两张图片,分别挑选两张图片中的最大人脸进行比较,判断是否为同一人。融合戴口罩生成、抗遮挡关键点定位、抗遮挡特征注意力三大技术优化,实现戴口罩时的极速人脸识别。

  • 两张人脸图片对比:比对两张图片中人脸的相似度,返回这两个人脸的矩形框坐标、人脸五点关键点坐标、比对的置信度,以及不同误识率的置信度阈值。
  • 支持多种图片类型:支持生活照、证件照等类型的人脸对比。
  • 支持佩戴口罩场景:针对佩戴口罩场景对带口罩的人脸进行对比识别。

关于该接口功能的示意图如下:

说明
  • 您可以进入在线咨询获取在线人工帮助。
    • 当前能力可在视觉智能开放平台有完整的免费产品体验,您可以单击立即试用对该能力进行更直观试用以及在线购买。
    • 阿里云视觉智能开放平台视觉 AI 能力 API 接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。

    应用场景

    • 员工考勤:无接触式刷脸考勤,疫情防控场景下企业考勤首选,且能有效防止代打卡等作弊行为。
    • 公共服务:佩戴口罩客户直接刷脸办理业务,通过人脸比对识别身份信息,减少身份证查验、复印存档等环节,提高公共服务窗口办理业务的效率。
    • 外卖骑手人脸核验:戴口罩外卖骑手送餐业务人脸打卡和定期本身人脸核验,现场授权采集的戴口罩人脸照片,与本人认证照片进行 1:1 比对,确保外卖骑手身份真实性,提供不摘口罩人脸识别便捷体验。

    特色优势

    • 平台服务稳定:提供在高并发,大流量下的毫秒级识别响应和保障。
    • 抗遮挡五官定位:支持戴口罩、大部分遮挡情况下,实现准确度自评估的鲁棒性关键点定位。
    • 抗遮挡特征建模:支持戴口罩、大部分遮挡情况下,实现基于注意力机制的鲁棒性特征建模。
    • 简单易用:可直接调用的 API 接口,服务简单易用,易被集成,兼容性强。
    • 佩戴口罩场景优化:针对佩戴口罩场景,优化戴口罩遮挡情境下的人脸比对。

    接入指引

    1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。
    2. 开通能力:请确保您已开通人脸人体服务,若未开通服务请立即开通
      注意

    本能力仅限企业认证用户开通。更多实名认证操作信息,请参见实名认证

    1. 创建 AccessKey:请确保您已创建 AccessKey,如果您使用的是子账号 AccessKey,您需要给子账号赋予 AliyunVIAPIFullAccess 权限,具体操作,请参见 RAM 授权
    2. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及 SDK 依赖信息,也可以下载完整的工程。
    3. 开发接入步骤:
    • SDK 总览中选择您要接入使用的 SDK 语言。
    • 在对应语言的 SDK 文档中找到 AI 类目为人脸人体(facebody)的 SDK 包进行安装。
    • 参考文档中提供的示例代码进行适当修改后调用。
    1. 示例代码:该能力常用语言的示例代码,请参见口罩人脸比对 1:1 示例代码

    2. 客户端直接调用:该能力常用的客户端调用方式包括以下几种。

    输入限制

    • 图像格式:JPEG、JPG、PNG、BMP、WEBP。
    • 图像大小:不超过 3 MB。
    • 图像分辨率:大于 32×32 像素,小于 4096×4096 像素,人脸占比不低于 64×64 像素。
    • URL 地址中不能包含中文字符。
    说明 当图像分辨率超过最大限制时,请先将图片进行缩放,调整图片大小,具体请参见图片缩放

    计费说明

    关于口罩人脸比对 1:1 的计费方式及报价,请参见计费介绍

    说明 下方调试接口为付费接口,如需免费体验调试请前往体验中心

    流控信息

    当前云产品API请求速率暂未透出。

    授权信息

    当前云产品暂无权限信息透出。

    请求参数

    字段名称字段详情
    ImageURLAstring

    图像 A 的 URL 地址。推荐使用上海地域的 OSS 链接,对于文件在本地或者非上海地域 OSS 链接的情况,请参见文件 URL 处理

    示例值:https://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/CompareFaceWithMask/CompareFaceWithMask-left1.jpeg参考取值来源:
      MergeImageFace
    ImageURLBstring

    图像 B 的 URL 地址。推荐使用上海地域的 OSS 链接,对于文件在本地或者非上海地域 OSS 链接的情况,请参见文件 URL 处理

    示例值:https://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/CompareFaceWithMask/CompareFaceWithMask-right1.jpeg参考取值来源:
      MergeImageFace
    QualityScoreThresholdnumber<float>

    质量分阈值,对人脸图片进行质量分析判断,若某张人脸质量分小于该阈值,则会在返回结果上增加 MessageTips 说明。

    示例值:97.0

    返回参数

    字段名称字段详情
    RequestIdstring

    请求 ID。

    示例值:C6499918-E932-41B3-96F5-A18F50D262DD
    Dataobject

    返回的结果数据内容。

    返回说明

    SDK 参考

    阿里云视觉 AI 人脸人体类目下的口罩人脸比对 1:1 能力推荐使用 SDK 调用,支持多种编程语言,调用时请选择 AI 类目为人脸人体(facebody)的 SDK 包,文件参数通过 SDK 调用可支持本地文件及任意 URL,具体可参见 SDK 总览

    示例代码

    该能力常用语言的示例代码,请参见口罩人脸比对 1:1 示例代码

    返回示例

    错误码

    全局错误码
    HTTP 状态码错误码错误信息操作
    400
    ParameterError
    The parameter is invalid. Please check again.诊断
    403
    AuthFailed
    An error occurred while performing authorization. Please check your RAM configuration.诊断
    408
    Timeout
    The request has timed out.诊断
    503
    ServiceUnavailable
    The service is unavailable.诊断

    变更历史

    暂无变更历史

    相关示例