Detect face masks and coverings in images
Identify whether individuals in images are wearing face masks. Get per-person detection with confidence scores, bounding boxes, and a summary of mask compliance. Ideal for workplace safety and public health monitoring.
Features
Mask Status Detection
Detect whether each person in an image is wearing a face mask, with per-person confidence scores.
Compliance Summary
Get an instant summary categorizing all detected persons as masked, unmasked, or indeterminate.
Multi-Person Support
Analyze images with multiple people — each person is individually identified and assessed.
Bounding Boxes
Get precise bounding box coordinates for both persons and their masks for overlay visualization.
Flexible Input
Upload a file via multipart or pass a public image URL — both work seamlessly.
Cloud-Based
No GPU needed on your end. Fully managed cloud infrastructure handles the processing.
API Reference
1 endpoint, simple integration. Here's everything you need.
Supported Content Types
https://mask-detection2.p.rapidapi.com/detect-maskDetect face coverings on individuals in an image. Returns per-person mask status with confidence scores, bounding boxes, and an overall summary.
imagefilerequiredImage file (JPEG, PNG, etc.) — use with multipart/form-data
urlstringrequiredPublic URL of the image to process — use with application/x-www-form-urlencoded
Send either image (file upload) or url (form-encoded), not both.
{
"statusCode": 200,
"body": {
"Persons": [
{
"Id": "person-1",
"Confidence": 0.99,
"Mask": {
"Confidence": 0.97,
"BoundingBox": { "left": 0.3, "top": 0.1, "width": 0.15, "height": 0.12 }
},
"BoundingBox": { "left": 0.2, "top": 0.05, "width": 0.3, "height": 0.8 }
}
],
"Summary": {
"PersonsWithMask": ["person-1"],
"PersonsWithoutMask": [],
"PersonsIndeterminate": []
}
}
}Response
Returns JSON with a list of detected persons (each with mask status, confidence, and bounding box) and a summary categorizing persons as with mask, without mask, or indeterminate.
Quick Start
Copy-paste code to get started in seconds. Replace YOUR_API_KEY with your RapidAPI key.
# File upload
curl -X POST "https://mask-detection2.p.rapidapi.com/detect-mask" \
-H "x-rapidapi-key: YOUR_API_KEY" \
-H "x-rapidapi-host: mask-detection2.p.rapidapi.com" \
-F "image=@photo.jpg"
# URL input
curl -X POST "https://mask-detection2.p.rapidapi.com/detect-mask" \
-H "x-rapidapi-key: YOUR_API_KEY" \
-H "x-rapidapi-host: mask-detection2.p.rapidapi.com" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "url=https://example.com/photo.jpg"Pricing
Start free, scale as you grow. All plans include full API access with no credit card required for the free tier.
Basic
30 requests/mo
- Full API access
- All endpoints
- Standard support
Pro
5,000 requests/mo
- Full API access
- All endpoints
- Standard support
Ultra
10,000 requests/mo
- Full API access
- All endpoints
- Standard support
Mega
50,000 requests/mo
- Full API access
- All endpoints
- Standard support
Start Using Mask Detection Today
Sign up on RapidAPI to get your API key. The free tier includes generous monthly requests — no credit card required.