---
url: https://docs.snapotter.com/sv/tools/image/compare.md
description: >-
  Jämför två bilder sida vid sida med diffvisualisering på pixelnivå och
  likhetspoäng.
---

# Bildjämförelse

Ladda upp två bilder för att beräkna en skillnadskarta på pixelnivå och en numerisk likhetsprocent. Utdatan är en diffbild som markerar ändrade områden i rött.

## API-slutpunkt

`POST /api/v1/tools/image/compare`

Tar emot multipart-formulärdata med **två** bildfiler. Inget inställningsfält behövs.

## Parametrar

Detta verktyg har inga konfigurerbara parametrar. Ladda upp exakt två bildfiler.

| Fält | Typ | Obligatorisk | Beskrivning |
|-------|------|----------|-------------|
| file (första) | file | Ja | Den första bilden |
| file (andra) | file | Ja | Den andra bilden |

## Exempelbegäran

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

## Exempelsvar

```json
{
  "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
}
```

## Svarsfält

| Fält | Typ | Beskrivning |
|-------|------|-------------|
| jobId | string | Jobbidentifierare för att ladda ner diffbilden |
| similarity | number | Procentuell likhet mellan de två bilderna (0 till 100) |
| dimensions | object | Bredd och höjd som används för jämförelsen |
| downloadUrl | string | URL för att ladda ner den genererade diffbilden |
| originalSize | number | Sammanlagd storlek på båda indatabilderna i byte |
| processedSize | number | Storlek på diffutdatabilden i byte |

## Anteckningar

* Båda bilderna storleksändras till samma dimensioner (maxvärdet för respektive axel) före jämförelsen.
* Diffbilden markerar skillnader i rött med en opacitet som är proportionell mot ändringens storlek. Identiska eller nästan identiska pixlar (skillnad < 10) visas som halvtransparenta versioner av originalet.
* Likheten beräknas som inversen av den genomsnittliga pixelskillnaden över alla pixlar, uttryckt i procent.
* En likhet på 100 % innebär att bilderna är pixelidentiska (vid jämförelseupplösningen).
* Diffutdatan är alltid i PNG-format oavsett indataformat.
* Båda bilderna valideras och avkodas (HEIC, RAW, PSD, SVG stöds) före jämförelsen.
* EXIF-orientering tillämpas automatiskt på båda bilderna före bearbetning.
