Visual Image Matcher

AI-ready visual verification API for detecting logos, ads, products, and brand assets on live webpages with confidence scores and proof.

原始信息汇总

数据集概述：Visual Image Matcher

平台：RapidAPI
类别：Video, Images
创建者：Ibo Mhd
订阅人数：3
定价方案：

• BASIC：$0.00 / 月
• PRO：$5.00 / 月
• ULTRA：$10.00 / 月
• MEGA：$15.00 / 月

性能指标：

• 流行度：9.2
• 服务等级：100%
• 延迟：877ms
• 测试覆盖率：40%

功能概述

Visual Image Matcher 是一个视觉图像匹配 API，用于检测指定图片是否出现在给定的网页上。其工作流程如下：

1. 在无头浏览器中加载目标网页
2. 捕获全页截图
3. 使用 OpenCV 在截图中搜索上传的图片
4. 返回匹配结果、置信度分数及边界框坐标

该 API 适用于视觉验证、品牌监控、截图检查、列表验证和网页内容检测等场景。

---

可用端点

方法	端点	描述
GET	/	返回基本 API 元数据
GET	/health	健康检查端点，返回 {"status": "ok"}
POST	/match	主要图像匹配端点

---

POST /match 请求参数

参数	类型	必填	默认值	描述
url	string	是	-	要检查的网页 URL（http/https）
file	binary	是	-	要搜索的二进制图片文件
threshold	number	否	70	置信度阈值（0-100）
wait_seconds	number	否	2	页面加载等待时间（0-10 秒）
viewport_width	number	否	1904	浏览器宽度（320-3840）
viewport_height	number	否	933	浏览器高度（320-2160）
browsers	string	否	"chromium,firefox"	逗号分隔的浏览器列表

---

响应格式（成功匹配示例）

json { "found": true, "confidence": 94.62, "threshold": 70.0, "box": { "x": 420, "y": 180, "width": 300, "height": 120 }, "scale": 1.0, "match_mode": "fast", "browser": "chromium", "screenshot": { "width": 1920, "height": 1080 }, "candidates": [ { "browser": "chromium", "found": true, "confidence": 94.62, "box": {"x": 420, "y": 180, "width": 300, "height": 120}, "scale": 1.0, "match_mode": "fast", "screenshot": {"width": 1920, "height": 1080} } ], "browser_errors": {} }

• found：布尔值，是否找到匹配
• confidence：匹配置信度（0-100）
• box：匹配的边界框坐标
• match_mode：使用的算法（"fast" 或 "precise"）
• browser：找到匹配的浏览器
• screenshot：捕获的页面尺寸

---

使用说明

• 认证：通过 RapidAPI 管理，需要提供 x-rapidapi-key 和 x-rapidapi-host 头信息。
• 测试：不能直接用 curl 测试，需通过 /docs 端点的 Swagger UI 进行交互式测试。
• 最佳实践：
  • 使用完整的 https:// 或 http:// URL
  • 上传图片应裁剪至需要匹配的内容区域
  • 目标页面需公开可访问，无需登录或验证码
• 限制：
  • 不支持表单提交、点击或多步导航
  • 动态内容可能导致结果变化
  • 小尺寸、低细节或透明图片可能匹配不佳
  • 受 robots.txt 或 IP 限制的页面可能失败

故障排除

• 未找到匹配：检查 URL 内容、降低阈值、确保图片在页面中可见
• 无效图片错误：确保文件为有效图片格式（如 .jpg、.png），使用 multipart/form-data 和 file 字段
• 页面捕获错误：验证 URL 可访问、增加 wait_seconds 参数
• 服务问题：通过 GET /health 检查服务状态，502 错误表示捕获/匹配失败