画像情報

寸法、形式、色空間、EXIF/ICC/XMP の有無、チャンネルごとのヒストグラム統計を含む包括的な画像メタデータを返す読み取り専用の分析ツールです。処理済みの出力ファイルは生成しません。

API エンドポイント

POST /api/v1/tools/image/info

画像ファイルを含む multipart フォームデータを受け付けます。設定フィールドは不要です。

パラメーター

このツールには設定可能なパラメーターがありません。画像ファイルをアップロードするだけです。

フィールド	型	必須	説明
file	file	はい	分析する画像

リクエスト例

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

レスポンス例

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

レスポンスフィールド

フィールド	型	説明
filename	string	サニタイズされたファイル名
fileSize	number	ファイルサイズ（バイト）
width	number	画像の幅（ピクセル）
height	number	画像の高さ（ピクセル）
format	string	検出された形式（jpeg、png、webp など）
channels	number	色チャンネルの数
hasAlpha	boolean	画像にアルファチャンネルがあるかどうか
colorSpace	string	色空間（srgb、cmyk など）
density	number または null	DPI/PPI 解像度
isProgressive	boolean	JPEG がプログレッシブエンコードを使用しているかどうか
orientation	number または null	EXIF の向きの値（1〜8）
hasProfile	boolean	ICC プロファイルが埋め込まれているかどうか
hasExif	boolean	EXIF メタデータが存在するかどうか
hasIcc	boolean	ICC カラープロファイルが存在するかどうか
hasXmp	boolean	XMP メタデータが存在するかどうか
bitDepth	string または null	サンプルあたりのビット数
pages	number	ページ数（TIFF、GIF などの複数ページ形式の場合）
histogram	array	チャンネルごとの統計（最小値、最大値、平均値、標準偏差）

注記

• これは読み取り専用のエンドポイントです。ダウンロード可能な出力ファイルや jobId は生成しません。
• RAW 形式の画像（DNG、CR2、NEF、ARW など）の場合、Sharp が直接読み取れない真のセンサー寸法とメタデータフラグを抽出するために ExifTool を使用します。
• HEIC/HEIF ファイルは、Sharp が HEVC ピクセルをデコードできないため、ピクセル統計を抽出するために内部で PNG にデコードされます。
• ヒストグラムは、完全な 256 ビン分布ではなく、チャンネルごとの最小値/最大値/平均値/標準偏差を提供します。
• density フィールドは、存在する場合、埋め込まれた DPI メタデータを反映します。