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

4.9 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Просмотр подробных метаданных изображения, свойств и постатейной статистики гистограммы по каналам.	8a0f7a0b0153	human	ddfe45cbea0c

Информация об изображении

Инструмент анализа только для чтения, возвращающий полные метаданные изображения, включая размеры, формат, цветовое пространство, наличие 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 декодируются в PNG внутренне для извлечения статистики пикселей, поскольку Sharp не может декодировать пиксели HEVC.
Гистограмма предоставляет мин/макс/среднее/стандартное отклонение по каналу, а не полное распределение из 256 корзин.
Поле density отражает встроенные метаданные DPI, если они присутствуют.

4.9 KiB Raw Blame History