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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Füllt ein Bild auf ein Zielseitenverhältnis mit einer Volltonfarbe, transparentem oder unscharfem Hintergrund auf.	796122da3dae	human	b15bb1ba9e66

Bild auffüllen

Füllt ein Bild auf ein Zielseitenverhältnis auf, indem ein Hintergrund aus einer Volltonfarbe, transparent oder unscharf darum herum hinzugefügt wird. Nützlich, um Bilder ohne Zuschneiden in feste Seitenverhältnisse für soziale Medien oder den Druck einzupassen.

API-Endpunkt

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

Akzeptiert Multipart-Formulardaten mit einer Bilddatei und einem JSON-Feld settings.

Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
target	string	Nein	`"1:1"`	Zielseitenverhältnis: `16:9`, `9:16`, `1:1`, `4:3`, `3:4` oder `custom`
ratioW	integer	Nein	`1`	Benutzerdefinierte Verhältnisbreite (1-100, verwendet, wenn target `custom` ist)
ratioH	integer	Nein	`1`	Benutzerdefinierte Verhältnishöhe (1-100, verwendet, wenn target `custom` ist)
background	string	Nein	`"color"`	Hintergrundmodus: `color`, `transparent` oder `blur`
color	string	Nein	`"#ffffff"`	Hintergrund-Hexfarbe (wenn background `color` ist)
padding	integer	Nein	`0`	Zusätzlicher Innenabstand als Prozentsatz der Leinwand (0-50)

Beispielanfrage

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

Beispielantwort

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

Hinweise

Der Hintergrundmodus blur erzeugt eine unscharfe Kopie des Originalbilds als Füllung, was ein visuell stimmiges Ergebnis liefert.
Bei Verwendung des Hintergrunds transparent wird die Ausgabe in PNG umgewandelt, um den Alphakanal zu erhalten.
Das Ausgabeformat entspricht dem Eingabeformat, es sei denn, Transparenz ist beteiligt. HEIC-, RAW-, PSD- und SVG-Eingaben werden vor der Verarbeitung automatisch decodiert.
Setzen Sie target auf custom und geben Sie ratioW und ratioH für beliebige Seitenverhältnisse an (z. B. ratioW: 3, ratioH: 2 für 3:2).

2.5 KiB Raw Blame History