Bildinformationen

Schreibgeschütztes Analysewerkzeug, das umfassende Bildmetadaten zurückgibt, darunter Abmessungen, Format, Farbraum, das Vorhandensein von EXIF/ICC/XMP und Histogrammstatistiken pro Kanal. Erzeugt keine verarbeitete Ausgabedatei.

API-Endpunkt

POST /api/v1/tools/image/info

Akzeptiert Multipart-Formulardaten mit einer Bilddatei. Es ist kein Einstellungsfeld erforderlich.

Parameter

Dieses Werkzeug hat keine konfigurierbaren Parameter. Laden Sie einfach die Bilddatei hoch.

Feld	Typ	Erforderlich	Beschreibung
file	file	Ja	Das zu analysierende Bild

Beispielanfrage

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

Beispielantwort

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

Antwortfelder

Feld	Typ	Beschreibung
filename	string	Bereinigter Dateiname
fileSize	number	Dateigröße in Bytes
width	number	Bildbreite in Pixeln
height	number	Bildhöhe in Pixeln
format	string	Erkanntes Format (jpeg, png, webp usw.)
channels	number	Anzahl der Farbkanäle
hasAlpha	boolean	Ob das Bild einen Alphakanal hat
colorSpace	string	Farbraum (srgb, cmyk usw.)
density	number oder null	DPI/PPI-Auflösung
isProgressive	boolean	Ob JPEG progressive Codierung verwendet
orientation	number oder null	EXIF-Ausrichtungswert (1-8)
hasProfile	boolean	Ob ein ICC-Profil eingebettet ist
hasExif	boolean	Ob EXIF-Metadaten vorhanden sind
hasIcc	boolean	Ob ein ICC-Farbprofil vorhanden ist
hasXmp	boolean	Ob XMP-Metadaten vorhanden sind
bitDepth	string oder null	Bits pro Sample
pages	number	Anzahl der Seiten (bei mehrseitigen Formaten wie TIFF, GIF)
histogram	array	Statistiken pro Kanal (Minimum, Maximum, Mittelwert, Standardabweichung)

Hinweise

• Dies ist ein schreibgeschützter Endpunkt. Er erzeugt keine herunterladbare Ausgabedatei und keine jobId.
• Bei Bildern im RAW-Format (DNG, CR2, NEF, ARW usw.) wird ExifTool verwendet, um die tatsächlichen Sensorabmessungen und Metadaten-Flags zu extrahieren, die Sharp nicht direkt lesen kann.
• HEIC/HEIF-Dateien werden intern zu PNG decodiert, um Pixelstatistiken zu extrahieren, da Sharp HEVC-Pixel nicht decodieren kann.
• Das Histogramm liefert Minimum/Maximum/Mittelwert/Standardabweichung pro Kanal, nicht eine vollständige Verteilung mit 256 Bins.
• Das Feld density gibt die eingebetteten DPI-Metadaten wieder, sofern vorhanden.