On-the-fly Video Optimization

How It Works

The video optimization workflow mirrors the image optimization pipeline:

  1. Set up an image source within your Gumlet dashboard.
  2. Backend Configuration: Our tech team must configure the source backend to enable the on-the-fly video optimization pipeline.
  3. 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.
  4. 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.

ParameterTypeDescription
wintegerResizes the output video by the specified width in pixels.
hintegerResizes the output video by the specified height in pixels.
durationintegerTrims the video to a specific duration (in seconds).
start_offsetintegerRemoves all video content preceding the specified timestamp (in seconds).
end_offsetintegerRemoves all video content following the specified timestamp (in seconds).
thumbnailbooleanthumbnail=true outputs the video thumbnail
thumbnail-widthintegerWhen combined with thumbnail=true, output the thumbnail with specified width
thumbnail-heightintegerWhen combined with thumbnail=true&thumbnail-width=500&mode=crop, output the thumbnail with specified width x height cropped

Real-Time Working Sample

ParameterVideo
NAhttps://votf.gumlet.io/7643454-sd_640_338_25fps.mp4

Width: 640
Height: 338
Duration: 17s
width=320https://votf.gumlet.io/7643454-sd_640_338_25fps.mp4?width=320
duration=9https://votf.gumlet.io/7643454-sd_640_338_25fps.mp4?duration=9
start_offset=5https://votf.gumlet.io/7643454-sd_640_338_25fps.mp4?start_offset=5
end_offset=4https://votf.gumlet.io/7643454-sd_640_338_25fps.mp4?end_offset=2
thumbnail=true

https://votf.gumlet.io/7643454-sd_640_338_25fps.mp4?thumbnail=true

thumbnail=true

thumbnail=true&thumbnail-width=300&thumbnail-height=300&mode=crop

https://votf.gumlet.io/7643454-sd_640_338_25fps.mp4?thumbnail=true&thumbnail-width=300&thumbnail-height=300&mode=crop

thumbnail=true&thumbnail-width=300&thumbnail-height=300&crop=mode