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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Змінюйте розмір зображень за пікселями, відсотками або з режимами вписування.	00d1bffa4d38	human	bd42371632d5

Зміна розміру

Змінюйте розмір зображень, вказуючи точні розміри в пікселях, коефіцієнт масштабу у відсотках або режим вписування, який контролює, як зображення адаптується до цільових розмірів.

Кінцева точка API

POST /api/v1/tools/image/resize

Приймає дані форми multipart із файлом зображення та полем 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 корисний для пакетної обробки, де деякі зображення можуть вже бути меншими за ціль.

3.9 KiB Raw Blame History