이미지 정보

치수, 형식, 색 공간, 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 메타데이터가 있는 경우 이를 반영합니다.