Files
SnapOtter/apps/docs/id/tools/image/info.md
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.3 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Lihat metadata gambar terperinci, properti, dan statistik histogram per-channel. 8a0f7a0b0153 human d007549742c9

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 "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 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.