mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

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.6 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
상세한 이미지 메타데이터, 속성 및 채널별 히스토그램 통계를 확인합니다.	8a0f7a0b0153	human	aef0fa4b0715

이미지 정보

치수, 형식, 색 공간, 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 "file=@photo.jpg"

예제 응답

{
  "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 메타데이터가 있는 경우 이를 반영합니다.

3.6 KiB Raw Blame History