mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

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

2.9 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Compara dos imágenes lado a lado con visualización de diferencias a nivel de píxel y puntuación de similitud.	cc0a02bd75c6	human	e74ad295a52e

Comparar imágenes

Sube dos imágenes para calcular un mapa de diferencias a nivel de píxel y un porcentaje numérico de similitud. La salida es una imagen de diferencias que resalta en rojo las regiones que cambiaron.

Endpoint de la API

POST /api/v1/tools/image/compare

Acepta datos de formulario multipart con dos archivos de imagen. No se necesita ningún campo de ajustes.

Parámetros

Esta herramienta no tiene parámetros configurables. Sube exactamente dos archivos de imagen.

Campo	Tipo	Obligatorio	Descripción
file (primero)	file	Sí	La primera imagen
file (segundo)	file	Sí	La segunda imagen

Ejemplo de solicitud

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"

Ejemplo de respuesta

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

Campos de respuesta

Campo	Tipo	Descripción
jobId	string	Identificador del trabajo para descargar la imagen de diferencias
similarity	number	Porcentaje de similitud entre las dos imágenes (0 a 100)
dimensions	object	Ancho y alto usados para la comparación
downloadUrl	string	URL para descargar la imagen de diferencias generada
originalSize	number	Tamaño combinado de ambas imágenes de entrada en bytes
processedSize	number	Tamaño de la imagen de diferencias de salida en bytes

Notas

Ambas imágenes se redimensionan a las mismas dimensiones (el máximo de cada eje) antes de la comparación.
La imagen de diferencias resalta las diferencias en rojo con una opacidad proporcional a la magnitud del cambio. Los píxeles idénticos o casi idénticos (diferencia < 10) se muestran como versiones semitransparentes del original.
La similitud se calcula como el inverso de la diferencia media de píxeles en todos los píxeles, expresada como porcentaje.
Una similitud del 100 % significa que las imágenes son idénticas píxel a píxel (a la resolución de comparación).
La salida de diferencias siempre está en formato PNG, sin importar los formatos de entrada.
Ambas imágenes se validan y decodifican (se admiten HEIC, RAW, PSD, SVG) antes de la comparación.
La orientación EXIF se aplica automáticamente a ambas imágenes antes del procesamiento.

2.9 KiB Raw Blame History