HomeTutorialsAPI ReferenceStatus
API Reference

Generate Video Thumbnails

post
https://{APP_DOMAIN}/api/3.2/contents/videos/thumbnails

Generates a GIF preview and/or a still image thumbnail for a video using Cloudinary. For Wistia videos the source URL is resolved automatically from player_data.video_id.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Body Params

string
required

The video player type (e.g. 'wistia', 'video.js').

player_data
object
required

Player-specific data. For 'wistia', include video_id. For others, include video_url, mp4, or webm.

integer
≥ 0

Start time (seconds) for the GIF preview.

integer
1 to 60

Duration (seconds) of the generated GIF. Between 1 and 60.

string
length ≤ 7

Optional 7-character hex color for the play-button overlay (e.g. '#ff0000').

integer

Optional existing asset ID to use as the still image source.

Responses
201

The generated thumbnails and associated asset metadata.

422

Validation failed, the video URL could not be resolved, or no thumbnails could be generated.

500

GIF generation failed unexpectedly.

Updated about 4 hours ago

Language
Credentials
Bearer
JWT
URL
LoadingLoading…

Updated about 4 hours ago