Image Info

Alat analisis read-only yang mengembalikan metadata gambar komprehensif termasuk dimensi, format, ruang warna, keberadaan EXIF/ICC/XMP, dan statistik histogram per-channel. Tidak menghasilkan file output yang telah diproses.

API Endpoint

POST /api/v1/tools/image/info

Menerima multipart form data dengan file gambar. Tidak diperlukan field pengaturan.

Parameters

Alat ini tidak memiliki parameter yang dapat dikonfigurasi. Cukup unggah file gambar.

Field	Type	Required	Description
file	file	Yes	Gambar yang akan dianalisis

Example Request

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

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	Nama file yang telah disanitasi
fileSize	number	Ukuran file dalam byte
width	number	Lebar gambar dalam piksel
height	number	Tinggi gambar dalam piksel
format	string	Format yang terdeteksi (jpeg, png, webp, dll.)
channels	number	Jumlah channel warna
hasAlpha	boolean	Apakah gambar memiliki channel alpha
colorSpace	string	Ruang warna (srgb, cmyk, dll.)
density	number or null	Resolusi DPI/PPI
isProgressive	boolean	Apakah JPEG menggunakan encoding progresif
orientation	number or null	Nilai orientasi EXIF (1-8)
hasProfile	boolean	Apakah ada profil ICC yang tersemat
hasExif	boolean	Apakah metadata EXIF ada
hasIcc	boolean	Apakah profil warna ICC ada
hasXmp	boolean	Apakah metadata XMP ada
bitDepth	string or null	Bit per sampel
pages	number	Jumlah halaman (untuk format multi-halaman seperti TIFF, GIF)
histogram	array	Statistik per-channel (min, max, mean, deviasi standar)

Notes

• Ini adalah endpoint read-only. Ia tidak menghasilkan file output yang dapat diunduh atau sebuah jobId.
• Untuk gambar format RAW (DNG, CR2, NEF, ARW, dll.), ExifTool digunakan untuk mengekstrak dimensi sensor asli dan flag metadata yang tidak dapat dibaca Sharp secara langsung.
• File HEIC/HEIF di-decode ke PNG secara internal untuk mengekstrak statistik piksel, karena Sharp tidak dapat men-decode piksel HEVC.
• Histogram menyediakan min/max/mean/stdev per channel, bukan distribusi 256-bin penuh.
• Field density mencerminkan metadata DPI yang tersemat, bila ada.