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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Изменение размера изображений по пикселям, процентам или с режимами вписывания.	00d1bffa4d38	human	dac4c31fbce7

Изменение размера

Изменение размера изображений путём указания точных пиксельных размеров, процентного коэффициента масштабирования или режима вписывания, который управляет тем, как изображение адаптируется к целевым размерам.

Эндпоинт API

POST /api/v1/tools/image/resize

Принимает multipart form data с файлом изображения и JSON-полем settings.

Параметры

Параметр	Тип	Обязательный	По умолчанию	Описание
width	integer	Нет	-	Целевая ширина в пикселях (максимум 16383)
height	integer	Нет	-	Целевая высота в пикселях (максимум 16383)
fit	string	Нет	`"contain"`	Как изображение вписывается в размеры: `contain`, `cover`, `fill`, `inside`, `outside`
withoutEnlargement	boolean	Нет	`false`	Не увеличивать масштаб, если изображение меньше целевого
percentage	number	Нет	-	Масштабирование в процентах (например, 50 для половинного размера)

Должен быть указан хотя бы один из width, height или percentage.

Режимы вписывания

contain - изменить размер так, чтобы вписаться в размеры, сохраняя соотношение сторон (может оставить пустое пространство)
cover - изменить размер так, чтобы покрыть размеры, сохраняя соотношение сторон (может обрезать)
fill - растянуть точно под размеры (игнорирует соотношение сторон)
inside - как contain, но только уменьшает, никогда не увеличивает
outside - как cover, но только уменьшает, никогда не увеличивает

Пример запроса

curl -X POST http://localhost:1349/api/v1/tools/image/resize \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"width": 800, "height": 600, "fit": "contain"}'

Изменение размера в процентах:

curl -X POST http://localhost:1349/api/v1/tools/image/resize \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"percentage": 50}'

Пример ответа

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
  "originalSize": 2450000,
  "processedSize": 980000
}

Примечания

Максимальный размер — 16383 пикселя по любой оси (ограничение Sharp/libvips).
Выходной формат совпадает с входным. Входные данные в форматах HEIC, RAW, PSD и SVG автоматически декодируются перед обработкой.
Ориентация по EXIF применяется автоматически перед изменением размера.
Флаг withoutEnlargement полезен для пакетной обработки, когда некоторые изображения могут уже быть меньше целевого.

4.1 KiB Raw Blame History