DetectMask可以对输入图片中面积最大的人脸进行口罩检测。

图片限制

  • 图片格式:JPEG、JPG、PNG、BMP。
  • 图片大小:图片大小不超过3M。
  • 图片分辨率:图片大小要求5x5像素以上,人脸的尺寸建议大于64x64像素。图像中人脸边长范围:最小人脸为图像长边的5%,最大人脸为图像短边的80%。

调试

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

请求参数

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

系统规定参数。取值:DetectMask。

ImageURL String https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/DetectImageElements/detect-elements-src.png

图片url地址(http/https)。

返回数据

名称 类型 示例值 描述
RequestId String D6C24839-91A7-41DA-B31F-98F08EF80CC0

当前请求的request id。

Data Struct

返回的数据内容。

Mask Integer 1
  • 0:没有检测出人脸或人脸清晰度不够。
  • 1:没有戴口罩。
  • 2:有戴口罩。
FaceProbability Float 0.999

人脸置信度,取值0~1。

示例

请求示例

https://facebody.cn-shanghai.aliyuncs.com/?Action=DetectMask&<公共请求参数>

正常返回示例

JSON 格式

{
  "RequestId": "D6C24839-91A7-41DA-B31F-98F08EF80CC0",
  "Data": {
    "Mask": 1,
    "FaceProbability":0.999
  }
}

错误码

具体请参见常见错误码