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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Optimiere Bilder für die Web-Auslieferung mit Formatkonvertierung, Qualitätssteuerung, Größenänderung und Metadaten-Entfernung.	c327bbbce768	human	03f7d1fd4362

Für Web optimieren

Optimiere Bilder für die Web-Auslieferung in einem einzigen Schritt. Kombiniert Formatkonvertierung, Qualitätsanpassung, optionale Größenänderung, progressive Kodierung und Metadaten-Entfernung.

API-Endpunkt

POST /api/v1/tools/image/optimize-for-web

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

Ein Live-Vorschau-Endpunkt ist außerdem unter POST /api/v1/tools/image/optimize-for-web/preview verfügbar, der das verarbeitete Bild direkt als Binärdaten zurückgibt (ohne Workspace-Erstellung) für die Echtzeit-Anpassung von Parametern.

Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
format	string	Nein	`"webp"`	Ausgabeformat: `webp`, `jpeg`, `avif`, `png`, `jxl`
quality	number	Nein	`80`	Ausgabequalität (1-100)
maxWidth	number	Nein	-	Maximale Breite in Pixeln. Das Bild wird herunterskaliert, wenn es breiter ist.
maxHeight	number	Nein	-	Maximale Höhe in Pixeln. Das Bild wird herunterskaliert, wenn es höher ist.
progressive	boolean	Nein	`true`	Progressive/interlaced Kodierung aktivieren
stripMetadata	boolean	Nein	`true`	EXIF-, GPS-, ICC- und XMP-Metadaten entfernen

Beispielanfrage

curl -X POST http://localhost:1349/api/v1/tools/image/optimize-for-web \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"format": "webp", "quality": 75, "maxWidth": 1920}'

Für AVIF mit aggressiver Kompression optimieren:

curl -X POST http://localhost:1349/api/v1/tools/image/optimize-for-web \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"format": "avif", "quality": 50, "maxWidth": 1200, "maxHeight": 800}'

Beispielantwort

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.webp",
  "originalSize": 4500000,
  "processedSize": 320000
}

Antwort des Vorschau-Endpunkts

Der Vorschau-Endpunkt (/api/v1/tools/image/optimize-for-web/preview) gibt das Bild direkt als Binärdaten mit informativen Headern zurück:

X-Original-Size - Ursprüngliche Dateigröße in Bytes
X-Processed-Size - Verarbeitete Dateigröße in Bytes
X-Output-Filename - URL-kodierter Ausgabedateiname

Hinweise

Dieses Werkzeug ist als vollständige Optimierungs-Pipeline für Web-Assets konzipiert. Es übernimmt Formatkonvertierung, Qualitätsanpassung, Begrenzung der maximalen Abmessungen und Metadaten-Entfernung in einem einzigen Durchlauf.
Die Endung des Ausgabedateinamens wird an das gewählte Format angepasst.
Die JXL-Kodierung (JPEG XL) verwendet einen spezialisierten CLI-Encoder. Das Bild wird zunächst als PNG verarbeitet und dann in JXL kodiert.
Progressive Kodierung verbessert die wahrgenommene Ladezeit von JPEG und PNG, da Browser eine Vorschau in niedriger Qualität rendern können, bevor das vollständige Bild geladen ist.
Der Vorschau-Endpunkt ist ressourcenschonender (keine Workspace-/Job-Erstellung) und für die Live-Parameteranpassung im Frontend gedacht.

3.5 KiB Raw Blame History