Skip to main content

​
Parameter Reference

Quick reference for all available parameters:
ParameterFull NameDescription
wwidthVideo width in pixels
hheightVideo height in pixels
ccropCrop mode for resizing
qqualityCompression quality using CRF (1-100)
sostart offsetStart time in seconds for trimming or thumbnail extraction
eoend offsetEnd time in seconds for trimming
fformatOutput format (mp4 for video, webp/jpeg/png for thumbnails)

​
Core Parameters

​
w
integer
Set the width of the video in pixels.Common resolutions:
  • w_1920 - Full HD 1080p width
  • w_1280 - HD 720p width
  • w_640 - Standard definition (SD) width
​
h
integer
Set the height of the video in pixels.Common resolutions:
  • h_1080 - Full HD 1080p height
  • h_720 - HD 720p height
  • h_480 - Standard definition (SD) height
  • h_360 - Low resolution preview height
​
c
string
Define how the video is cropped during resizing.Available modes:
  • fill - Fill entire area, cropping if necessary (scale + crop strategy)
  • crop - Resize and crop to exact dimensions
​
q
integer
default:"75"
Control video quality using encoding. Range: 1-100.Quality mapping:
  • q_100 → CRF 18 (very high quality, large file)
  • q_85 → CRF 23 (high quality, recommended)
  • q_75 → CRF 28 (good quality, balanced)
  • q_50 → CRF 35 (medium quality, smaller file)
  • q_10 → CRF 45 (low quality, minimum size)
​
so
number
Set the start time in seconds for video trimming or thumbnail extraction. When used with eo, creates a trimmed video segment. When used with f (image format), extracts a single frame as a thumbnail.Examples:
  • so_5 - Start at 5 seconds
  • so_0 - Start from the beginning
  • so_10.5 - Start at 10.5 seconds (supports decimals)
​
eo
number
Set the end time in seconds for video trimming. Must be used together with so to create a trimmed video segment. The resulting video duration is eo - so seconds.Examples:
  • eo_12 - End at 12 seconds (exclusive)
  • eo_30 - End at 30 seconds
  • eo_15.5 - End at 15.5 seconds (supports decimals)
The end offset is exclusive, meaning a video trimmed with so_5,eo_12 will be 7 seconds long (from 5s to 12s).
​
f
string
Force a specific output format. For videos, defaults to MP4. When combined with so (and without eo), extracts a single frame as an image thumbnail.Video formats:
  • mp4 - Standard video format (default)
Thumbnail formats:
  • webp - Modern format, excellent compression
  • jpeg / jpg - Universal image format
  • png - Lossless format with transparency support
Combine so with f_webp or f_jpeg to extract a single frame as a thumbnail image.

​
Video Examples

GET /t/w_1280,h_720,q_80/video.mp4
Convert to 720p HD with high quality encoding.

​
Supported Video Formats

The system accepts the following video formats as input:
  • MP4 - With H.264 or H.265 codecs
  • MOV - QuickTime format
  • WebM - With VP8 or VP9 codecs

​
Use Cases

GET /t/w_1080,h_1080,q_85/social.mp4
Create square videos optimized like Instagram and X feeds.
GET /t/w_640,h_360,q_65/video.mp4
Generate low-bandwidth versions for mobile users on slower connections.
GET /t/w_1920,h_1080,q_95/presentation.mp4
Maintain maximum quality for professional presentations and demos.
GET /t/w_400,h_300,so_5,eo_12/video.mp4
Extract a specific segment from a video. This example creates a 7-second clip (from 5s to 12s) resized to 400×300 pixels. Perfect for creating highlights, previews, or extracting specific moments from longer videos.
GET /t/w_400,h_300,so_5,f_webp/video.mp4
Generate thumbnail images from videos by extracting a single frame at a specific timestamp. Combine so with an image format (f_webp, f_jpeg, or f_png) to create thumbnails for video galleries, preview cards, or social media sharing.
For videos that will be viewed frequently, consider pre-generating them to use the cached version.

​
Performance Considerations

Video transformations are significantly more resource-intensive than image operations. Keep these factors in mind:

Processing time

Video processing can take 5-30 seconds depending on original file resolution and quality settings.

Cache efficiency

Cached video transformations are served in under 50ms, making caching essential for performance.

Storage impact

Higher quality settings result in larger file sizes. Balance quality against storage costs.

Bandwidth usage

Consider delivering lower resolutions to mobile devices to reduce bandwidth consumption.
Avoid on-demand video transformations for high-traffic scenarios. Pre-process videos during upload or content ingestion whenever possible.