Трансформації

Зміна розміру, кадрування, конвертація формату та оптимізація зображень на льоту через URL-параметри.

Ширина800

Висота600

Якість85

Формат

Режим вписування

https://media.fastpic.pro/42d00a45-e45b-405a-950b-88929d855b9a?w=800&h=600&q=85&fmt=auto&fit=cover

Як працюють трансформації

При запиті media.fastpic.pro/{publicId}?w=800&fmt=webp media-proxy забирає оригінал зі сховища, застосовує трансформації через Sharp і стримить результат у браузер. Трансформовані зображення кешуються на edge, тому повторні запити обслуговуються з CDN.

Довідник параметрів

Param	Values	Description
w	1-2000	Ширина результату в пікселях.
h	1-2000	Висота результату в пікселях.
q	1-100	Якість кодувальника JPEG/WebP, де 100 — без втрат.
fmt	auto, webp, jpeg, png, avif	Формат виводу. auto обирає на основі заголовка Accept (сучасні браузери отримують WebP/AVIF).
fit	cover, contain, inside, outside	Спосіб масштабування зображення під width/height. cover обрізає до заповнення, contain зменшує до вписування, inside зменшує, але не збільшує, outside збільшує до заповнення.

Приклади

thumb.ts

// Resize to 800px wide WebP at 85% quality
const src = 'https://media.fastpic.pro/img_a1b2c3d4?w=800&fmt=webp&q=85'

Кешування

Усі трансформовані зображення містять заголовки Cache-Control (max-age=2592000, public). Після підключення Cloudflare CDN перед media.fastpic.pro (відкладено до MVP-1) повторні трансформації віддаватимуться з edge-кешу, не досягаючи origin.