Duplicaten zoeken

Upload meerdere afbeeldingen om duplicaten en bijna-duplicaten te detecteren met perceptuele hashing (dHash). Groepeert vergelijkbare afbeeldingen, identificeert de versie met de beste kwaliteit in elke groep en berekent de potentiële ruimtebesparing.

API Endpoint

POST /api/v1/tools/image/find-duplicates

Accepteert multipart-formuliergegevens met meerdere afbeeldingsbestanden en een optioneel JSON-veld settings.

Parameters

Parameter	Type	Vereist	Standaard	Beschrijving
threshold	number	Nee	8	Maximale Hamming-afstand om afbeeldingen als duplicaten te beschouwen (0 tot 20). Lager = strengere matching

Bestandsvelden

Upload minstens 2 afbeeldingsbestanden in het multipart-verzoek (allemaal met de veldnaam file of een willekeurige veldnaam voor bestandsonderdelen).

Voorbeeldverzoek

curl -X POST http://localhost:1349/api/v1/tools/image/find-duplicates \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F 'settings={"threshold": 8}'

Voorbeeldantwoord

{
  "totalImages": 4,
  "duplicateGroups": [
    {
      "groupId": 1,
      "files": [
        {
          "filename": "photo1.jpg",
          "similarity": 100,
          "width": 4032,
          "height": 3024,
          "fileSize": 2450000,
          "format": "jpeg",
          "isBest": true,
          "thumbnail": "data:image/jpeg;base64,/9j/..."
        },
        {
          "filename": "photo2.jpg",
          "similarity": 96.88,
          "width": 1920,
          "height": 1440,
          "fileSize": 850000,
          "format": "jpeg",
          "isBest": false,
          "thumbnail": "data:image/jpeg;base64,/9j/..."
        }
      ]
    }
  ],
  "uniqueImages": 2,
  "spaceSaveable": 850000,
  "skippedFiles": []
}

Antwoordvelden

Veld	Type	Beschrijving
totalImages	number	Aantal succesvol geanalyseerde afbeeldingen
duplicateGroups	array	Groepen dubbele afbeeldingen
uniqueImages	number	Aantal afbeeldingen dat geen deel uitmaakt van een duplicaatgroep
spaceSaveable	number	Totaal aantal bytes dat bespaard kan worden door niet-beste duplicaten te verwijderen
skippedFiles	array	Bestanden die niet verwerkt konden worden (met bestandsnaam en reden)

Duplicaatgroep-object

Veld	Type	Beschrijving
groupId	number	Groeps-identifier
files	array	Afbeeldingen in deze duplicaatgroep

Bestandsobject (binnen een groep)

Veld	Type	Beschrijving
filename	string	Oorspronkelijke bestandsnaam
similarity	number	Overeenkomstpercentage met de referentieafbeelding (eerste in de groep)
width	number	Afbeeldingsbreedte in pixels
height	number	Afbeeldingshoogte in pixels
fileSize	number	Bestandsgrootte in bytes
format	string	Afbeeldingsformaat
isBest	boolean	Of dit de versie met de hoogste kwaliteit is (meeste pixels, grootste bestand)
thumbnail	string of null	Base64 JPEG-thumbnail (200px breed) voor voorbeeldweergave

Opmerkingen

• Gebruikt een 128-bits dHash (64-bits rij + 64-bits kolom) voor perceptuele overeenkomstdetectie. Dit vangt duplicaten zelfs bij vergrotingen/verkleiningen, hercompressie en kleine bewerkingen.
• De drempelwaarde vertegenwoordigt de maximale Hamming-afstand tussen hashes. De standaardwaarde van 8 vangt bijna-duplicaten terwijl valse positieven worden vermeden. Gebruik 0 voor alleen pixel-identieke afbeeldingen, of 15-20 voor zeer losse matching.
• De "beste" afbeelding in elke groep is die met de meeste pixels (breedte x hoogte), met de bestandsgrootte als tiebreaker.
• Er zijn minstens 2 afbeeldingen vereist. Bestanden die niet slagen voor validatie of decodering worden gerapporteerd in skippedFiles in plaats van dat het hele verzoek mislukt.
• Thumbnails zijn 200px brede JPEG-voorbeelden gecodeerd als data-URI's.
• Alle gangbare formaten worden ondersteund (HEIC, RAW, PSD, SVG worden automatisch gedecodeerd).