Skip to main content

Thumbnails

Generate a custom thumbnail

POST /v1/api/{orgID}/videos/{publicID}/thumbnails

Body:

{ "width": 320, "height": 180, "timestampMs": 12000 }

Response includes a jobId and final worker url.

Poll status

GET /v1/api/thumbnails/{jobID}

When completed, use the returned url (served by the worker).

Best thumbnail

The details endpoint includes the best available thumbnail if one exists.