Comparaison d'images

Téléversez deux images pour calculer une carte des différences au niveau du pixel et un pourcentage de similarité numérique. La sortie est une image de différence mettant en évidence les régions modifiées en rouge.

API Endpoint

POST /api/v1/tools/image/compare

Accepte des données de formulaire multipart avec deux fichiers image. Aucun champ de réglages n'est nécessaire.

Parameters

Cet outil n'a aucun paramètre configurable. Téléversez exactement deux fichiers image.

Champ	Type	Requis	Description
file (premier)	file	Oui	La première image
file (second)	file	Oui	La deuxième image

Example Request

curl -X POST http://localhost:1349/api/v1/tools/image/compare \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F "[email protected]"

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

Champ	Type	Description
jobId	string	Identifiant de tâche pour télécharger l'image de différence
similarity	number	Pourcentage de similarité entre les deux images (0 à 100)
dimensions	object	Largeur et hauteur utilisées pour la comparaison
downloadUrl	string	URL pour télécharger l'image de différence générée
originalSize	number	Taille combinée des deux images d'entrée en octets
processedSize	number	Taille de l'image de différence en sortie en octets

Notes

• Les deux images sont redimensionnées aux mêmes dimensions (le maximum de chaque axe) avant la comparaison.
• L'image de différence met en évidence les écarts en rouge avec une opacité proportionnelle à l'ampleur du changement. Les pixels identiques ou quasi identiques (différence < 10) sont affichés sous forme de versions semi-transparentes de l'original.
• La similarité est calculée comme l'inverse de la différence moyenne des pixels sur l'ensemble des pixels, exprimée en pourcentage.
• Une similarité de 100 % signifie que les images sont identiques au pixel près (à la résolution de comparaison).
• La sortie de différence est toujours au format PNG, quels que soient les formats d'entrée.
• Les deux images sont validées et décodées (HEIC, RAW, PSD, SVG pris en charge) avant la comparaison.
• L'orientation EXIF est appliquée automatiquement sur les deux images avant le traitement.