Skip to main content
Video processing is resource-intensive (5–30s per file). For high-traffic assets, prewarm transformed variants at upload time so the first request is served from cache.

​
Parameters

ParameterFull nameDescription
wwidthWidth in pixels
hheightHeight in pixels
ccropCrop/resize mode
qqualityQuality via CRF (1–100)
sostart offsetStart time in seconds
eoend offsetEnd time in seconds (trim)
fformatOutput format

​
Parameter reference

​
w
integer
Width of the output video in pixels.w_1920 (1080p) · w_1280 (720p) · w_640 (SD)
​
h
integer
Height of the output video in pixels.h_1080 · h_720 · h_480 · h_360
​
c
string
Resize/crop strategy.
ValueBehavior
fillScale and crop to fill the target dimensions
cropResize and crop to exact dimensions
​
q
integer
default:"75"
Video quality via encoding. Range: 1–100.
q valueCRFNotes
10018Very high quality
8523High quality, recommended
7528Balanced (default)
5035Smaller file, noticeable loss
1045Low quality, minimum size
​
so
number
Start time in seconds. Used for trimming (with eo) or thumbnail extraction (with an image f).so_5 · so_10.5
​
eo
number
End time in seconds. Must be used together with so. The output duration is eo − so.so_5,eo_12 → 7-second clip
The end offset is exclusive: so_5,eo_12 produces a clip from 5s to 12s (7 seconds).
​
f
string
Output format. Defaults to mp4 (H.264). When combined with so and without eo, extracts a single frame as an image.
ValueUse case
mp4Re-encoded video (H.264) — default
webpFrame thumbnail
jpeg / jpgFrame thumbnail
pngFrame thumbnail with transparency

​
Examples

GET /t/w_1280,h_720,q_80/video.mp4

GET /t/w_1080,h_1080,q_85/social.mp4

GET /t/w_400,h_300,so_5,eo_12/video.mp4
7-second clip (5s → 12s) resized to 400×300.
GET /t/w_1920,h_1080,q_95/presentation.mp4

​
Supported formats

Input: MP4 (H.264/H.265), MOV, WebM (VP8/VP9) Output: MP4 (H.264) — standardized for maximum device and browser compatibility

​
Next steps

Upload & Cache Warming

Pre-generate video variants at upload time — video jobs are background-queued.

Video Processing Config

Tune worker concurrency, retries, and job cleanup.