On-the-fly Video Optimization

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
`Original`	`https://votf.gumlet.io/7643454-sd_640_338_25fps.mp4` Width: 640 Height: 338 Duration: 17s
`width=320`	`https://votf.gumlet.io/7643454-sd_640_338_25fps.mp4?width=320`
`duration=9`	`https://votf.gumlet.io/7643454-sd_640_338_25fps.mp4?duration=9`
`start_offset=5`	`https://votf.gumlet.io/7643454-sd_640_338_25fps.mp4?start_offset=5`
`end_offset=4`	`https://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-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&time=10`	`https://votf.gumlet.io/7643454-sd_640_338_25fps.mp4?thumbnail=true&time=10`
`thumbnail=true&time=10&format=gif`	`https://votf.gumlet.io/7643454-sd_640_338_25fps.mp4?thumbnail=true&time=10&format=gif`