Informacje o obrazie

Narzędzie analityczne tylko do odczytu, które zwraca kompleksowe metadane obrazu, w tym wymiary, format, przestrzeń kolorów, obecność EXIF/ICC/XMP oraz statystyki histogramu dla poszczególnych kanałów. Nie tworzy przetworzonego pliku wyjściowego.

Punkt końcowy API

POST /api/v1/tools/image/info

Przyjmuje dane formularza multipart z plikiem obrazu. Pole ustawień nie jest potrzebne.

Parametry

To narzędzie nie ma konfigurowalnych parametrów. Wystarczy przesłać plik obrazu.

Pole	Typ	Wymagany	Opis
file	file	Tak	Obraz do analizy

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Pola odpowiedzi

Pole	Typ	Opis
filename	string	Oczyszczona nazwa pliku
fileSize	number	Rozmiar pliku w bajtach
width	number	Szerokość obrazu w pikselach
height	number	Wysokość obrazu w pikselach
format	string	Wykryty format (jpeg, png, webp itd.)
channels	number	Liczba kanałów kolorów
hasAlpha	boolean	Czy obraz ma kanał alfa
colorSpace	string	Przestrzeń kolorów (srgb, cmyk itd.)
density	number lub null	Rozdzielczość DPI/PPI
isProgressive	boolean	Czy JPEG używa kodowania progresywnego
orientation	number lub null	Wartość orientacji EXIF (1-8)
hasProfile	boolean	Czy osadzony jest profil ICC
hasExif	boolean	Czy obecne są metadane EXIF
hasIcc	boolean	Czy obecny jest profil kolorów ICC
hasXmp	boolean	Czy obecne są metadane XMP
bitDepth	string lub null	Bity na próbkę
pages	number	Liczba stron (dla formatów wielostronicowych, takich jak TIFF, GIF)
histogram	array	Statystyki dla poszczególnych kanałów (min, max, średnia, odchylenie standardowe)

Uwagi

• To punkt końcowy tylko do odczytu. Nie tworzy pliku wyjściowego do pobrania ani jobId.
• W przypadku obrazów w formacie RAW (DNG, CR2, NEF, ARW itd.) do wyodrębnienia rzeczywistych wymiarów sensora i flag metadanych, których Sharp nie potrafi odczytać bezpośrednio, używany jest ExifTool.
• Pliki HEIC/HEIF są dekodowane wewnętrznie do PNG w celu wyodrębnienia statystyk pikseli, ponieważ Sharp nie potrafi dekodować pikseli HEVC.
• Histogram dostarcza min/max/średnią/odchylenie standardowe na kanał, a nie pełny rozkład z 256 przedziałami.
• Pole density odzwierciedla osadzone metadane DPI, jeśli są obecne.