Files
SnapOtter/apps/docs/fr/tools/image/compare.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

3.0 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Comparez deux images côte à côte avec une visualisation des différences au niveau du pixel et un score de similarité. cc0a02bd75c6 human fc7fc59014a7

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 "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

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.