本文介绍口罩人脸比对VerifyFaceMask语法及示例。

功能描述

口罩人脸比对能力用于检测两张人脸（图像中人脸可能带口罩）是否属于同一个人脸。

应用场景

疫情防控期间的身份确认：在疫情防控期间，通过对已授权的佩戴口罩的照片识别，比对识别人员身份，可免接触免摘口罩安全通行。

特色优势

适应口罩遮挡：在佩戴口罩的情况下，依然识别出是否为同一人。

前提条件

请确保您已开通人脸人体服务，若未开通服务请立即开通。

输入限制

  • 图像格式：JPEG、JPG、BMP、PNG。
  • 图像大小：不超过3M。
  • 图像分辨率：大于32×32像素，小于2048×2048像素，人脸占比不低于64×64像素。
  • URL地址中不能包含中文字符。
  • 可使用URL与Base64编码字符串混合输入。例如：输入ImageURL和RefData的值，不输入RefUrl和ImageData的值。
说明 当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见图片缩放。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 VerifyFaceMask

要执行的操作。取值：VerifyFaceMask。
ImageURL String 否 https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/ceshi/VerifyFaceMaskA.jpg

待检测图像A的URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。

RefUrl String 否 https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/ceshi/VerifyFaceMaskB.jpg

待检测的图像B的URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。

ImageData String 否 iVBORw0KGgoAAAANSUhEUgAAAoAAAAHJCAIAAACaEB9NAAEAAElEQVR4nNT9Wb****

待检测图像A的Base64编码字符串。当与URL方式共存时，URL方式优先。
RefData String 否 iVBORw0KGgoAAAANSUhEUgAAAoAAAAHJCAIAAACaEB9NAAEAAElEQVR4nNT9WbA****

待检测图像B的Base64编码字符串。当与URL方式共存时，URL方式优先。

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。
Confidence Float 13.484533309936523

两种图片中人脸为同一个人的置信度。取值范围0~100。
Mask Integer 2

图像1中的人脸是否带口罩。取值如下：

  • 0：非人脸。
  • 1：没戴口罩。
  • 2：正确戴口罩。
  • 3：错误戴口罩。
MaskRef Integer 2

图像2中的人脸是否带口罩。取值如下：

  • 0：非人脸。
  • 1：没戴口罩。
  • 2：正确戴口罩。
  • 3：错误戴口罩。
Rectangle List [542,200,229,296]

图像1的人脸检测框。格式为[left, top, right, bottom]。

RectangleRef List [534,70,261,338]

图像2的人脸检测框。格式为[left, top, right, bottom]。

Thresholds List [61,69,75]

误识率在10e-3，10e-4，10e-5时对应的置信度分类阈值。
RequestId String 044386BA-271C-4DAD-9E08-581A685FB984

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=VerifyFaceMask
&ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/ceshi/VerifyFaceMaskA.jpg
&RefUrl=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/ceshi/VerifyFaceMaskB.jpg
&<公共请求参数>

正常返回示例

XML格式 

<RequestId>044386BA-271C-4DAD-9E08-581A685FB984</RequestId>
<Data>
    <Thresholds>61</Thresholds>
    <Thresholds>69</Thresholds>
    <Thresholds>75</Thresholds>
    <Confidence>13.484533309936523</Confidence>
    <Mask>2</Mask>
    <Rectangle>542</Rectangle>
    <Rectangle>200</Rectangle>
    <Rectangle>229</Rectangle>
    <Rectangle>296</Rectangle>
    <RectangleRef>534</RectangleRef>
    <RectangleRef>70</RectangleRef>
    <RectangleRef>261</RectangleRef>
    <RectangleRef>338</RectangleRef>
    <MaskRef>2</MaskRef>
</Data>

JSON格式 

{
	"RequestId": "044386BA-271C-4DAD-9E08-581A685FB984",
	"Data": {
		"Thresholds": [
			61,
			69,
			75
		],
		"Confidence": "13.484533309936523",
		"Mask": 2,
		"Rectangle": [
			542,
			200,
			229,
			296
		],
		"RectangleRef": [
			534,
			70,
			261,
			338
		],
		"MaskRef": 2
	}
}

错误码

关于口罩人脸比对的错误码，详情请参见常见错误码。

SDK参考

阿里云视觉AI能力支持使用SDK调用，具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。