图像信息

只读分析工具，返回全面的图像元数据，包括尺寸、格式、色彩空间、EXIF/ICC/XMP 是否存在，以及各通道直方图统计信息。不会生成处理后的输出文件。

API 端点

POST /api/v1/tools/image/info

接受包含一个图像文件的 multipart 表单数据。无需 settings 字段。

参数

此工具没有可配置参数。只需上传图像文件即可。

字段	类型	是否必填	说明
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	图像是否有 alpha 通道
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 等），会使用 ExifTool 提取 Sharp 无法直接读取的真实传感器尺寸和元数据标志。
• HEIC/HEIF 文件会在内部解码为 PNG 以提取像素统计信息，因为 Sharp 无法解码 HEVC 像素。
• 直方图提供每个通道的最小值/最大值/平均值/标准差，而非完整的 256 桶分布。
• density 字段反映嵌入的 DPI 元数据（如果存在）。