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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Дополнение изображения до целевого соотношения сторон сплошным цветом, прозрачным или размытым фоном.	796122da3dae	human	18967f298442

Дополнение изображения

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

Конечная точка API

POST /api/v1/tools/image/image-pad

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

Параметры

Параметр	Тип	Обязательный	По умолчанию	Описание
target	string	Нет	`"1:1"`	Целевое соотношение сторон: `16:9`, `9:16`, `1:1`, `4:3`, `3:4` или `custom`
ratioW	integer	Нет	`1`	Пользовательская ширина соотношения (1-100, используется при target равном `custom`)
ratioH	integer	Нет	`1`	Пользовательская высота соотношения (1-100, используется при target равном `custom`)
background	string	Нет	`"color"`	Режим фона: `color`, `transparent` или `blur`
color	string	Нет	`"#ffffff"`	Фоновый цвет в hex (когда background равен `color`)
padding	integer	Нет	`0`	Дополнительный отступ в процентах от холста (0-50)

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

curl -X POST http://localhost:1349/api/v1/tools/image/image-pad \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"target": "16:9", "background": "blur", "padding": 5}'

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

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

Примечания

Режим фона blur создаёт размытую копию исходного изображения в качестве заполнения полей, давая визуально цельный результат.
При использовании фона transparent вывод конвертируется в PNG для сохранения альфа-канала.
Выходной формат совпадает с входным, если только не задействована прозрачность. Входные данные HEIC, RAW, PSD и SVG декодируются автоматически перед обработкой.
Установите target в custom и укажите ratioW и ratioH для произвольных соотношений сторон (например, ratioW: 3, ratioH: 2 для 3:2).

3.4 KiB Raw Blame History