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

Files

T

SnapOtterandGitHub 00b651c9f8 feat(i18n): 21-language pipeline, landing/docs/API wiring, landing+API translations

Shared Claude Code translation pipeline (scripts/i18n, no API key) plus Astro/VitePress/Scalar i18n wiring. Landing and API reference translated into all 20 languages; docs i18n wiring + English source anchors. The translated docs markdown (apps/docs/<locale>/**, 3,620 files) follows in a companion PR because it exceeds GitHub's per-PR CI file limit.

2026-07-11 13:01:55 +08:00

3.2 KiB

Raw Blame History

description

description
View detailed image metadata, properties, and per-channel histogram statistics.

Image Info

Read-only analysis tool that returns comprehensive image metadata including dimensions, format, color space, EXIF/ICC/XMP presence, and per-channel histogram statistics. Does not produce a processed output file.

API Endpoint

POST /api/v1/tools/image/info

Accepts multipart form data with an image file. No settings field is needed.

Parameters

This tool has no configurable parameters. Simply upload the image file.

Field	Type	Required	Description
file	file	Yes	The image to analyze

Example Request

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

Example Response

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

Response Fields

Field	Type	Description
filename	string	Sanitized filename
fileSize	number	File size in bytes
width	number	Image width in pixels
height	number	Image height in pixels
format	string	Detected format (jpeg, png, webp, etc.)
channels	number	Number of color channels
hasAlpha	boolean	Whether the image has an alpha channel
colorSpace	string	Color space (srgb, cmyk, etc.)
density	number or null	DPI/PPI resolution
isProgressive	boolean	Whether JPEG uses progressive encoding
orientation	number or null	EXIF orientation value (1-8)
hasProfile	boolean	Whether an ICC profile is embedded
hasExif	boolean	Whether EXIF metadata is present
hasIcc	boolean	Whether an ICC color profile is present
hasXmp	boolean	Whether XMP metadata is present
bitDepth	string or null	Bits per sample
pages	number	Number of pages (for multi-page formats like TIFF, GIF)
histogram	array	Per-channel statistics (min, max, mean, standard deviation)

Notes

This is a read-only endpoint. It does not produce a downloadable output file or a jobId.
For RAW format images (DNG, CR2, NEF, ARW, etc.), ExifTool is used to extract true sensor dimensions and metadata flags that Sharp cannot read directly.
HEIC/HEIF files are decoded to PNG internally to extract pixel statistics, since Sharp cannot decode HEVC pixels.
The histogram provides min/max/mean/stdev per channel, not a full 256-bin distribution.
The density field reflects the embedded DPI metadata, if present.

3.2 KiB Raw Blame History