Shelf AI Vision

Detect products in shelf photos and return clean category labels with bounding boxes.

原始信息汇总

Shelf AI Vision 数据集/API 详情总结

基本信息

• 名称: Shelf AI Vision
• 分类: Visual Recognition（视觉识别）
• 所属平台: RapidAPI
• 提供者: Shelf AI Vision
• 订阅人数: 1

核心功能

将零售货架图片转化为结构化的产品层级数据。上传一张货架照片，即可返回检测到的产品边界框、置信度分数和每个物品的类别标签。适用于货架审计、零售质量检测、商品目录清理、货架陈列图合规检查以及内部销售工具。

应用场景

• 货架审计
• 货架陈列图合规检查
• 零售质量检测
• 商品目录清理
• 销售分析

端点说明

方法	端点	功能描述
POST	/v1/analyze	检测货架照片中的产品，返回包含检测结果的JSON对象
POST	/v1/visualize	在原始货架照片上绘制边界框和标签，返回带标注的PNG图片
GET	/health/live	轻量级存活检查，用于监控和正常运行时间检查，不消耗请求配额

输入要求

• 支持的图片格式: JPEG、PNG、WEBP
• 最大上传大小: 25 MB
• 字段名称: image
• 编码方式: multipart/form-data

输出格式示例（/v1/analyze）

json { "status": "success", "detections": [ { "label": "bottled_water", "confidence": 0.94, "bbox": [120, 45, 210, 300] }, { "label": "soda_can", "confidence": 0.89, "bbox": [225, 50, 310, 295] } ], "image_width": 1280, "image_height": 720 }

• bbox 格式：[x_min, y_min, x_max, y_max]，单位为像素。

认证方式

所有请求需包含标准 RapidAPI 网关头部：

• X-RapidAPI-Key：个人 RapidAPI 订阅密钥
• X-RapidAPI-Host：shelf-ai-vision.p.rapidapi.com

错误处理

HTTP 状态码	含义	建议操作
400	无效输入	检查输入格式及内容