Visual Diff API

Compare two images and get an SSIM similarity score (0-1) plus bounding boxes of changed regions. Accepts base64 or image URLs. Optional visual diff PNG.

原始信息汇总

Visual Diff API 数据集详情

类别：Visual Recognition（视觉识别）

提供者：Hyuninterojo

订阅状态：1 位订阅者

API 版本：0.1.0（当前版本）

定价计划：

• BASIC：$0.00/月
• PRO：$5.00/月

性能指标：

• 流行度：8.3
• 服务级别：100%
• 延迟：26954ms

---

功能概述

该 API 用于比较两张图像，返回以下信息：

• similarity：SSIM 结构相似性得分，范围为 0.0（完全不同）到 1.0（完全相同）
• diff_regions：每个变化区域的边界框坐标（x, y, width, height）
• visual_png_base64（可选）：在第二张图像上用红色框标出差异区域的 PNG 图像（以 base64 编码）

技术基础：基于经典计算机视觉（OpenCV SSIM），结果具有确定性，不保留图像数据。

---

输入格式

• image1 和 image2 均接受：
  • Base64 字符串
  • Data URI
  • 公共图像 URL（由服务端抓取）
• 文件限制：最大 5 MB，最长边不超过 4096 像素
• 若两张图像尺寸不同，image2 会被调整为与 image1 匹配，响应中会设置 "resized": true

---

使用场景

• 视觉回归测试：捕获部署之间意外的 UI 变化
• 屏幕截图监控：检测页面或仪表板的变化
• 文档/设计质量检查：验证渲染输出是否与批准版本一致
• 重复检测：评估两张产品图片的相似度

---

错误处理

• 无效的 base64、非图像数据、无法访问的 URL 以及超过大小限制的图像均返回 400 状态码
• 错误信息中包含可读的 detail 字段，指明有问题的字段

---

示例

请求体： json { "image1": "<base64 or URL>", "image2": "<base64 or URL>", "return_visual": false }

响应体： json { "similarity": 0.979865, "region_count": 1, "diff_regions": [{"x": 233, "y": 153, "width": 95, "height": 95}], "resized": false }

---

端点

• GET /health：健康检查
• GET /compare：图像比较（分类：Visual Recognition）