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

3.6 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Consulta metadatos, propiedades y estadísticas de histograma por canal detallados de una imagen.	8a0f7a0b0153	human	c1e00b8a5016

Información de la imagen

Herramienta de análisis de solo lectura que devuelve metadatos completos de la imagen, incluidos las dimensiones, el formato, el espacio de color, la presencia de EXIF/ICC/XMP y estadísticas de histograma por canal. No produce un archivo de salida procesado.

Endpoint de la API

POST /api/v1/tools/image/info

Acepta datos de formulario multipart con un archivo de imagen. No se necesita ningún campo de configuración.

Parámetros

Esta herramienta no tiene parámetros configurables. Simplemente sube el archivo de imagen.

Campo	Tipo	Obligatorio	Descripción
file	file	Sí	La imagen a analizar

Ejemplo de solicitud

curl -X POST http://localhost:1349/api/v1/tools/image/info \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg"

Ejemplo de respuesta

{
  "filename": "photo.jpg",
  "fileSize": 2450000,
  "width": 4032,
  "height": 3024,
  "format": "jpeg",
  "channels": 3,
  "hasAlpha": false,
  "colorSpace": "srgb",
  "density": 72,
  "isProgressive": false,
  "orientation": 1,
  "hasProfile": true,
  "hasExif": true,
  "hasIcc": true,
  "hasXmp": false,
  "bitDepth": "8",
  "pages": 1,
  "histogram": [
    { "channel": "red", "min": 0, "max": 255, "mean": 128.45, "stdev": 52.31 },
    { "channel": "green", "min": 2, "max": 253, "mean": 115.22, "stdev": 48.76 },
    { "channel": "blue", "min": 0, "max": 250, "mean": 102.89, "stdev": 55.14 }
  ]
}

Campos de la respuesta

Campo	Tipo	Descripción
filename	string	Nombre de archivo saneado
fileSize	number	Tamaño del archivo en bytes
width	number	Ancho de la imagen en píxeles
height	number	Alto de la imagen en píxeles
format	string	Formato detectado (jpeg, png, webp, etc.)
channels	number	Número de canales de color
hasAlpha	boolean	Si la imagen tiene un canal alfa
colorSpace	string	Espacio de color (srgb, cmyk, etc.)
density	number o null	Resolución DPI/PPI
isProgressive	boolean	Si el JPEG usa codificación progresiva
orientation	number o null	Valor de orientación EXIF (1-8)
hasProfile	boolean	Si hay un perfil ICC incrustado
hasExif	boolean	Si hay metadatos EXIF presentes
hasIcc	boolean	Si hay un perfil de color ICC presente
hasXmp	boolean	Si hay metadatos XMP presentes
bitDepth	string o null	Bits por muestra
pages	number	Número de páginas (para formatos multipágina como TIFF, GIF)
histogram	array	Estadísticas por canal (mín., máx., media, desviación estándar)

Notas

Este es un endpoint de solo lectura. No produce un archivo de salida descargable ni un jobId.
Para las imágenes en formato RAW (DNG, CR2, NEF, ARW, etc.), se usa ExifTool para extraer las dimensiones reales del sensor y los indicadores de metadatos que Sharp no puede leer directamente.
Los archivos HEIC/HEIF se decodifican internamente a PNG para extraer las estadísticas de píxeles, ya que Sharp no puede decodificar píxeles HEVC.
El histograma proporciona mín./máx./media/desviación estándar por canal, no una distribución completa de 256 bins.
El campo density refleja los metadatos de DPI incrustados, si están presentes.

3.6 KiB Raw Blame History