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

功能描述

VerifyFaceMask接口用于检测两张人脸(图像中人脸可能带口罩)是否属于同一个人脸。

前提条件

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

输入限制

  • 图片格式:JPEG、JPG、BMP、PNG。
  • 图片大小:大小不超过3M。
  • 图片分辨率:图片最小要求5×5像素,图片中人脸建议大于64×64像素。
  • URL地址中不能包含中文字符。

调试

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

请求参数

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

要执行的操作。取值:VerifyFaceMask。

ImageURL String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/ceshi/VerifyFaceMaskA.jpg

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

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

待检测的图片URL地址。当前仅支持上海地域的OSS链接,如何生成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小时后会被系统自动清理删除。