Skip to Content
Mux Docs: Home
Retrieve an animated image from a video
get

Fetch an animated GIF or WebP image from a video segment with optional transformations.

Request path & query params
PLAYBACK_ID
string

The asset or live stream's playback ID.

TOKEN
string

Signed token (JWT) for secure video playback.

EXTENSION
string
Possible values: "gif""webp"

The image file extension, either 'gif' or 'webp'.

start
number

The time (in seconds) of the video timeline where the animated GIF should begin. Defaults to 0.

end
number

The time (in seconds) of the video timeline where the GIF ends. Defaults to 5 seconds after the start. Maximum total duration of GIF is limited to 10 seconds; minimum total duration of GIF is 250ms.

width
integer

The width in pixels of the animated GIF. Default is 320px, or if height is provided, the width is determined by preserving aspect ratio with the height. Max width is 640px.

height
integer

The height in pixels of the animated GIF. The default height is determined by preserving aspect ratio with the width provided. Maximum height is 640px.

fps
integer

The frame rate of the generated GIF. Defaults to 15 fps. Max 30 fps.

get
200
https://image.mux.com/{PLAYBACK_ID}/animated.{EXTENSION}