AI Mask Detector in Photos

AI-powered mask detection API that analyzes photos to identify whether people are wearing face masks. Ideal for safety compliance, monitoring, and smart applications.

原始信息汇总

AI Mask Detector in Photos 数据集概述

基本信息

• 数据集名称：AI Mask Detector in Photos
• 提供平台：RapidAPI
• 类别：Video, Images
• API版本：v1 (current)
• 定价方案：
  • BASIC: $0.00 / mo
  • PRO: $9.00 / mo
  • ULTRA: $79.00 / mo
  • MEGA: $749.00 / mo
• 性能指标：
  • 流行度：0
  • 服务等级：0%
  • 延迟：241ms
  • 测试状态：N/A

核心功能描述

AI Mask Detector API 自动分析照片以判断人物是否佩戴了口罩。该API由先进的计算机视觉技术驱动，为公共安全、工作场所合规、医疗保健和智能监控系统等应用提供准确、快速和可靠的结果。

主要特性：

• 口罩检测：识别检测到的人脸上是否存在口罩。
• 高准确度：即使在不同的光照和角度下也能实现稳健识别。
• 可扩展且快速：支持批量照片分析，响应延迟低。
• 易于集成：简单的RESTful API，便于无缝集成到工作流中。
• 注重隐私：仅分析图像，不存储或共享用户内容。

关键特性

• 🎯 准确检测：使用先进AI进行高精度口罩检测。
• 👥 多人脸支持：在单张图像中检测多个人脸的口罩。
• 📊 详细分析：提供包含置信度分数的全面检测结果。
• 🔄 批量处理：同时高效处理多张图像。
• 🔒 安全处理：通过RapidAPI代理密钥进行身份验证。
• 📱 多种格式：支持JPG、PNG、WebP、BMP等格式。
• ⚡ 快速处理：为实时应用提供快速分析。
• 📈 置信度评分：为每次检测提供详细的置信度级别。

API端点

方法	端点	描述
POST	/mask-detect	检测单张图像中的口罩
POST	/mask-detect-batch	检测多张图像中的口罩

端点详情

POST /mask-detect - 检测口罩

分析单张图像以检测人物是否佩戴口罩。

请求头：

头信息	类型	必需	描述
Content-Type	string	✅	必须为 application/json
X-RapidAPI-Key	string	✅	用于身份验证的RapidAPI API密钥

请求体： json { "image_url": "https://example.com/person.jpg" }

参数：

参数	类型	必需	描述	示例
image_url	string	✅	用于口罩检测的源图像URL	"https://example.com/photo.jpg", "https://example.com/group.jpg"

响应示例： json { "success": true, "detections": [ { "face_id": 1, "mask_detected": true, "confidence": 0.95, "bounding_box": { "x": 120, "y": 80, "width": 150, "height": 180 } }, { "face_id": 2, "mask_detected": false, "confidence": 0.87, "bounding_box": { "x": 320, "y": 90, "width": 145, "height": 175 } } ], "summary": { "total_faces": 2, "masks_worn": 1, "masks_not_worn": 1, "compliance_rate": 0.5 }, "processing_time_seconds": 1.23 }

响应字段：

字段	类型	描述
success	boolean	检测是否成功
detections	array	人脸检测结果数组
detections[].face_id	number	每个检测到的人脸的唯一标识符
detections[].mask_detected	boolean	此人脸上是否检测到口罩
detections[].confidence	number	口罩检测的置信度分数（0-1）
detections[].bounding_box	object	人脸边界框的坐标
summary	object	所有检测的汇总统计
summary.total_faces	number	检测到的总人脸数
summary.masks_worn	number	检测到佩戴口罩的人脸数
summary.masks_not_worn	number	未佩戴口罩的人脸数
summary.compliance_rate	number	佩戴口罩人脸数与总人脸数的比率
processing_time_seconds	number	总处理时间（秒）

POST /mask-detect-batch - 批量口罩检测

同时处理多张图像以进行高效的批量分析。

请求头：

头信息	类型	必需	描述
Content-Type	string	✅	必须为 application/json
X-RapidAPI-Key	string	✅	用于身份验证的RapidAPI API密钥

请求体： json { "image_urls": [ "https://example.com/image1.jpg", "https://example.com/image2.jpg", "https://example.com/image3.jpg" ] }

参数：

参数	类型	必需	描述	示例
image_urls	array	✅	用于批量处理的图像URL数组	["https://example.com/img1.jpg", "https://example.com/img2.jpg"]

批量限制：

• 最大图像数：每个批量请求最多10张图像。
• 图像格式：支持JPG、PNG、WebP、BMP。
• 处理方式：所有图像并行处理以提高效率。

响应示例： json { "success": true, "results": [ { "image_url": "https://example.com/image1.jpg", "status": "success", "detections": [ { "face_id": 1, "mask_detected": true, "confidence": 0.92, "bounding_box": { "x": 100, "y": 75, "width": 140, "height": 170 } } ], "summary": { "total_faces": 1, "masks_worn": 1, "masks_not_worn": 0, "compliance_rate": 1.0 } }, { "image_url": "https://example.com/image2.jpg", "status": "success", "detections": [ { "face_id": 1, "mask_detected": false, "confidence": 0.89, "bounding_box": { "x": 85, "y": 60, "width": 155, "height": 185 } }, { "face_id": 2, "mask_detected": true, "confidence": 0.94, "bounding_box": { "x": 280, "y": 70, "width": 148, "height": 178 } } ], "summary": { "total_faces": 2, "masks_worn": 1, "masks_not_worn": 1, "compliance_rate": 0.5 } } ], "batch_summary": { "total_images": 2, "successful_images": 2, "failed_images": 0, "total_faces": 3, "total_masks_worn": 2, "total_masks_not_worn": 1, "average_compliance_rate": 0.75 }, "processing_time_seconds": 2.45 }

批量响应字段：

字段	类型	描述
results	array	每张图像的结果数组
results[].image_url	string	原始图像URL
results[].status	string	处理状态（success 或 error）
results[].error	string	如果状态为 error 时的错误信息
batch_summary	object	所有图像的汇总统计
batch_summary.total_images	number	处理的总图像数
batch_summary.successful_images	number	成功处理的图像数
batch_summary.failed_images	number	处理失败的图像数
batch_summary.average_compliance_rate	number	所有图像的平均合规率

集成示例

提供了JavaScript、Python和cURL的完整集成代码示例，包括单张图像检测和批量处理。

错误处理

常见错误及解决方案：

• 未经授权的访问：验证 X-RapidAPI-Key 头信息值。
• 无效图像URL：确保图像URL可访问且有效。
• 不支持的图像格式：使用支持的格式（JPG、PNG、WebP、BMP）。
• 未检测到人脸：检查图像质量并确保人脸清晰可见。
• 批量大小超出限制：减少批量请求中的图像数量。

最佳实践

图像质量指南：

• ✅ 清晰人脸：确保人脸光照良好且清晰可见。
• ✅ 适当分辨率：更高分辨率的图像提供更好的准确度。
• ✅ 人脸朝向：正面或接近正面的人脸效果最佳。
• ✅ 图像尺寸：平衡质量与处理速度（推荐：800x600 至 1920x1080）。

检测优化：

• ✅ 单人：为获得最佳准确度，使用具有一个主要主体的图像。
• ✅ 人脸大小：人脸应至少占据图像的10%。
• ✅ 光照：良好、均匀的光照提高检测准确度。
• ✅ 遮挡：尽量减少阴影和遮挡面部的物体。

批量处理技巧：

• ✅ 相似内容：对相似的图像进行分组以获得一致的结果。
• ✅ 错误处理：为失败的图像实施重试逻辑。
• ✅ 进度跟踪：监控批量处理进度。
• ✅ 速率限制：对于大批量处理，请遵守API速率限制。

热门用例

• 医疗保健和医疗机构：患者筛查、员工监控、访客合规、容量管理。
• 企业和办公环境：员工安全、会议室、公共区域、返岗计划。
• 零售和酒店业：客户安全、员工合规、容量控制、活动管理。
• 交通和公共场所：机场安检、公共交通、活动场所、政府建筑。
• 教育和学校：学生安全、校园安全、活动监控、交通。

处理性能

支持的格式和限制：

• 图像格式：JPG、JPEG、PNG、WebP、BMP、TIFF。
• 图像大小：每张图像最多10MB。
• 分辨率：最多4096x4096像素。
• 批量限制：每批最多10张图像。
• 处理时间：通常每张图像1-3秒。

性能因素：

因素	对速度的影响	对准确度的影响
图像分辨率	更高 = 更慢	更高 = 更好
图像大小	更大 = 更慢	更大 = 更好
人脸数量	更多人脸 = 更慢	更多人脸 = 相同
图像质量	质量越低 = 越快	质量越低 = 越差
网络速度	更快 = 更快	无影响

隐私与安全

数据保护：

• 安全处理：所有请求均通过RapidAPI代理密钥进行身份验证。
• 无存储：图像不会永久存储在服务器上。
• 加密传输：所有数据通过HTTPS传输。
• 临时处理：图像在内存中处理并立即删除。

隐私合规：

• GDPR合规：设计支持隐私法规。
• 无个人数据：仅返回口罩检测结果。
• 访问日志：为安全和调试进行最少的日志记录。
• 数据最小化：仅处理和保留必要的数据。

检测置信度级别

• 高置信度（0.9-1.0）：非常可靠的检测结果。
• 中等置信度（0.7-0.9）：通常可靠，需考虑上下文。
• 低置信度（0.5-0.7）：不确定的结果，可能需要人工审核。
• 极低置信度（<0.5）：不可靠的检测，不建议用于自动化决策。