OOsstblok

Bild-Transformationen (/m/)

Vollständige Referenz für das /m/-URL-Suffix: Resize, Crop, Format-Negotiation, Quality und Filter.

URL-Aufbau

Hänge /m/<BxH>[/filters:<f1>:<f2>] an die Roh-Asset-URL. Storage prüft den Key gegen die Allow-List-Regex und streamt den transformierten Output. Ergebnisse sind am Proxy cachebar.

http
GET /storage/v1/spaces/1/assets/42/photo.jpg/m/800x600/filters:format(webp):quality(80)
Auf 800x600 resizen und als WebP ausliefern.

Grössen-Tokens

  • 800x600 — in 800×600 einpassen, Seitenverhältnis bleibt.

  • 800x0 — Breite setzen, Höhe automatisch.

  • 0x600 — Höhe setzen, Breite automatisch.

  • fit-in/800x600 — Letterbox in die Box.

  • smart/800x600 — Content-Aware Crop (Gesichter, Salience).

Filter

  • format(webp|avif|jpeg|png) — Output-Format erzwingen. AVIF nur bei ALLOW_AVIF=1.

  • quality(1..100) — Encoder-Qualität; Default 80.

  • blur(0..100) — Gauss-Blur-Radius.

  • grayscale() — Entsaturierung.

  • brightness(-100..100), contrast(-100..100), saturation(-100..100).

  • rotate(90|180|270).

  • focal(x:y) — Fokalpunkt für Smart-Crops (0..1 pro Achse).

http
GET /storage/v1/spaces/1/assets/42/hero.jpg/m/smart/600x600/filters:format(webp):quality(70)
Kombiniert: Smart-Crop auf 600x600, WebP, 70% Qualität.