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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Erzeugt einen winzigen Platzhalter in niedriger Qualität mit Base64-Data-URI.	f8a27c8021f5	human	a18e4151550b

LQIP-Platzhalter

Erzeugt einen winzigen Platzhalter in niedriger Qualität (LQIP) aus einem Ausgangsbild. Gibt eine kleine Platzhalterdatei zusammen mit einem Base64-Data-URI, einem fertigen HTML-<img>-Tag und einem CSS-background-image-Snippet zum sofortigen Einbetten zurück.

API-Endpunkt

POST /api/v1/tools/image/lqip-placeholder

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

Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
width	integer	Nein	`16`	Zielbreite in Pixeln (4-64)
blur	number	Nein	`2`	Unschärferadius für die Unschärfe-Strategie (0-20)
strategy	string	Nein	`"blur"`	Platzhalter-Strategie: `blur`, `pixelate` oder `solid`
format	string	Nein	`"webp"`	Ausgabeformat: `webp`, `png` oder `jpeg`
quality	integer	Nein	`50`	Ausgabequalität (1-100)

Beispielanfrage

curl -X POST http://localhost:1349/api/v1/tools/image/lqip-placeholder \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"width": 20, "strategy": "blur", "format": "webp"}'

Beispielantwort

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.webp",
  "originalSize": 2450000,
  "processedSize": 280,
  "dataUri": "data:image/webp;base64,UklGR...",
  "width": 20,
  "height": 13,
  "bytes": 280,
  "strategy": "blur",
  "html": "<img src=\"data:image/webp;base64,UklGR...\" />",
  "css": "background-image:url('data:image/webp;base64,UklGR...');background-size:cover;background-position:center;"
}

Hinweise

Das Feld dataUri enthält den vollständigen Data-URI, bereit zur Verwendung in src-Attributen oder CSS ohne zusätzliche Anfragen.
Die Felder html und css liefern zum Kopieren fertige Snippets für gängige Anwendungsfälle.
Die Strategie blur erzeugt ein weiches, unscharfes Vorschaubild. Die Strategie pixelate erstellt ein klotziges Mosaik. Die Strategie solid gibt eine einzige gemittelte Farbe zurück.
Typische Platzhaltergrößen liegen bei 200-500 Bytes, was sie für das direkte Inlining in HTML geeignet macht.
Die Höhe wird automatisch berechnet, um das Seitenverhältnis des Ausgangsbilds zu erhalten.
HEIC-, RAW-, PSD- und SVG-Eingaben werden vor der Verarbeitung automatisch decodiert.

2.7 KiB Raw Blame History