APIs › Image, SVG, QR & Barcode › Image Duplicate Detection

Image Duplicate Detection

Groups images into near-duplicate sets by perceptual-hash Hamming distance at a configurable threshold.

POST /v1/image/duplicate-detect $0.01 per call

Specification

Endpoint

POST /v1/image/duplicate-detect

Price

$0.01 per call · tier standard_data

Payment

x402 on X Layer (chain 196) · settled in USDG or USDT0 · scheme exact

Data source

Local sandboxed processing of the uploaded image

Timeout

60 seconds

Max request

20 MB

Version

1.0.0

Calling it

The first call returns a 402 with the payment challenge. Retry with a signed authorisation in the X-PAYMENT header — see the payment guide for the exact shape.

curl -i -X POST "https://api.dana-edu.pp.ua/v1/image/duplicate-detect" \
  -H "content-type: application/json" \
  -d '{ ... }'

Response

Real output, captured by running this endpoint at build time — not written by hand. Volatile fields such as timestamps are elided. Captured 2026-07-30.

{
  "algorithm": "phash",
  "threshold": 5,
  "image_count": 3,
  "unique_images": 3,
  "duplicate_groups": 0,
  "groups": [],
  "matching_pairs": [],
  "hashes": [
    {
      "filename": "<varies per call>",
      "hash": "ae1193ee311999e6"
    },
    {
      "filename": "<varies per call>",
      "hash": "ae1199e6e31199e6"
    },
    {
      "filename": "<varies per call>",
      "hash": "ae1191ee6211b3ee"
    }
  ],
  "method": "pairwise Hamming distance on perceptual hashes, grouped with union-find so a chain of similar images forms a single group"
}

Every response is wrapped in the same envelope: data plus warnings, sources, confidence, informational_only and a measured processing_ms. See the envelope reference.

Related endpoints