imgix APIs
Video API
Frame Generation

Frame Generation


For any video asset that is encoded by imgix (it should have an domain), you can generate a still image, a gif, or a storyboard by using the video-generate parameter.

Valid values are thumbnail, gif, and storyboard.

Note that requests to the video-generate parameter do not trigger the transcoding process, and will return a 404 if the video has not been transcoded yet.


Thumbnails are commonly used as the preview image before a video is played.

Passing video-generate=thumbnail will return an image url that can be transformed with any existing Image Rendering API params. By default, this will return a JPG.

You can add a poster image to the majority of video players by including an imgix image URL. Here's an example using a HTML5 video element with a poster image attribute.


Use video-thumbnail-time to specify the time, in seconds, which should be used to generate the thumbnail. If video-thumbnail-time is not set it will default to somewhere in the middle of the video.


Passing video-generate=gif will return a gif URL that can be transformed with any existing Image Rendering API params.

Gifs are often used as a preview when a user hovers over a video before playing it.



Storyboards can be used to create timeline hover previews when quickly scrubbing through a video. Storyboards consist of numerous frames from the video tiled into one large image file.

Setting a video-storyboard-format to jpg or png will generate one of these large tiled files. They can be used in conjunction with metadata files that map video timestamps to the coordinates of the corresponding video frame in the storyboard image file. Metadata files can be generated by setting video-storyboard-format to vtt or json.

Most popular video players support using a WebVTT file to enable timeline hover previews.


00:00:00.000 --> 00:00:00.959,0,232,160
00:00:00.959 --> 00:00:01.918,0,232,160
00:00:22.062 --> 00:00:23.021,640,232,160
00:00:23.021 --> 00:00:24.080,640,232,160

However, if you would like to implement timeline hover previews without using WebVTT you can get the same information in json format as well.