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

2.4 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Dopełnij obraz do docelowych proporcji jednolitym kolorem, przezroczystym lub rozmytym tłem.	796122da3dae	human	47d27ff89e89

Dopełnianie obrazu

Dopełnij obraz do docelowych proporcji, dodając wokół niego jednolity kolor, przezroczyste lub rozmyte tło. Przydatne do dopasowywania obrazów do stałych proporcji dla mediów społecznościowych lub druku bez przycinania.

Punkt końcowy API

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

Przyjmuje dane formularza multipart z plikiem obrazu oraz polem JSON settings.

Parametry

Parametr	Typ	Wymagany	Domyślnie	Opis
target	string	Nie	`"1:1"`	Docelowe proporcje: `16:9`, `9:16`, `1:1`, `4:3`, `3:4` lub `custom`
ratioW	integer	Nie	`1`	Niestandardowa szerokość proporcji (1-100, używana gdy target to `custom`)
ratioH	integer	Nie	`1`	Niestandardowa wysokość proporcji (1-100, używana gdy target to `custom`)
background	string	Nie	`"color"`	Tryb tła: `color`, `transparent` lub `blur`
color	string	Nie	`"#ffffff"`	Kolor tła w formacie hex (gdy background to `color`)
padding	integer	Nie	`0`	Dodatkowy odstęp jako procent kanwy (0-50)

Przykładowe żądanie

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}'

Przykładowa odpowiedź

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

Uwagi

Tryb tła blur tworzy rozmytą kopię oryginalnego obrazu jako wypełnienie dopełnienia, dając wizualnie spójny rezultat.
Podczas używania tła transparent wynik jest konwertowany na PNG w celu zachowania kanału alfa.
Format wyjściowy odpowiada formatowi wejściowemu, chyba że w grę wchodzi przezroczystość. Wejścia HEIC, RAW, PSD i SVG są automatycznie dekodowane przed przetwarzaniem.
Ustaw target na custom i podaj ratioW oraz ratioH dla dowolnych proporcji (np. ratioW: 3, ratioH: 2 dla 3:2).

2.4 KiB Raw Blame History