mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtter 7db6bb97da docs: add per-tool API documentation and fix parity gaps

- Create 53 per-tool VitePress documentation pages with accurate
  parameters from Zod schemas, example requests, and response formats
- Add root llms.txt for LLM-friendly repo browsing
- Fix OpenAPI spec: add auth and 422 error schemas to
  edit-metadata/inspect and strip-metadata/inspect sub-routes
- Fix tool count inconsistency (52 -> 53) across landing site,
  e2e tests, and local docs
- Rename color-adjustments.ts to adjust-colors.ts to match tool ID
- Update VitePress sidebar with all 8 tool categories and top nav

2026-06-08 11:52:28 +08:00

2.4 KiB

Raw Blame History

description

description
Compare two images side by side with pixel-level diff visualization and similarity score.

Image Compare

Upload two images to compute a pixel-level difference map and a numerical similarity percentage. The output is a diff image highlighting changed regions in red.

API Endpoint

POST /api/v1/tools/compare

Accepts multipart form data with two image files. No settings field is needed.

Parameters

This tool has no configurable parameters. Upload exactly two image files.

Field	Type	Required	Description
file (first)	file	Yes	The first image
file (second)	file	Yes	The second image

Example Request

curl -X POST http://localhost:1349/api/v1/tools/compare \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@original.jpg" \
  -F "file=@modified.jpg"

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "similarity": 94.52,
  "dimensions": { "width": 1920, "height": 1080 },
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/diff.png",
  "originalSize": 4900000,
  "processedSize": 280000
}

Response Fields

Field	Type	Description
jobId	string	Job identifier for downloading the diff image
similarity	number	Percentage similarity between the two images (0 to 100)
dimensions	object	Width and height used for comparison
downloadUrl	string	URL to download the generated diff image
originalSize	number	Combined size of both input images in bytes
processedSize	number	Size of the diff output image in bytes

Notes

Both images are resized to the same dimensions (the maximum of each axis) before comparison.
The diff image highlights differences in red with opacity proportional to the magnitude of change. Identical or near-identical pixels (difference < 10) are shown as semi-transparent versions of the original.
Similarity is calculated as the inverse of the average pixel difference across all pixels, expressed as a percentage.
A similarity of 100% means the images are pixel-identical (at the comparison resolution).
The diff output is always PNG format regardless of input formats.
Both images are validated and decoded (HEIC, RAW, PSD, SVG supported) before comparison.
EXIF orientation is auto-applied on both images before processing.

2.4 KiB Raw Blame History