On-the-fly Video Optimization
The on-the-fly (OTF) video optimization pipeline allows you to dynamically manipulate, resize, and trim video assets using simple URL query parameters. This offers a highly scalable solution to process videos on the fly for large enterprises.
How It Works
The video optimization workflow mirrors the image optimization pipeline:
- Set up an image source within your Gumlet dashboard.
- Backend Configuration: Our tech team must configure the source backend to enable the on-the-fly video optimization pipeline.
- Delivery: Fetch a video through your Gumlet Subdomain (e.g.,
example.gumlet.io/file.mp4). The video is instantly pushed to the optimization pipeline on its initial request. - Storage: The fully processed file is delivered to and saved in your configured workspace, using that workspace's default optimization and encoding settings.
Availability Note
This feature is currently restricted to selected accounts. If you need this configured for your workspace storage origin, please reach out to chat support for additional configuration info.
Interactive Parameter Reference for Video API
Use these parameters in your query strings to modify video outputs in real time.
| Parameter | Type | Description |
|---|---|---|
w |
integer |
Resizes the output video by the specified width in pixels. |
h |
integer |
Resizes the output video by the specified height in pixels. |
duration |
integer |
Trims the video to a specific duration (in seconds). |
start_offset |
integer |
Removes all video content preceding the specified timestamp (in seconds). |
end_offset |
integer |
Removes all video content following the specified timestamp (in seconds). |
thumbnail |
boolean |
thumbnail=true outputs the video thumbnail |
thumbnail-width |
integer |
When combined with thumbnail=true, output the thumbnail with specified width |
thumbnail-height |
integer |
When combined with thumbnail=true&thumbnail-width=500&mode=crop, output the thumbnail with specified width x height cropped. |
time |
integer |
When combined with thumbnail=true, output the thumbnail from the video at specified time. |
format=gif |
string | When combined with thumbnail=true, output the GIF from the video. You can also time param to get the GIF from the specified time. |
Examples with different parameters
Parameter | Video |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
