Skip to main content

Fetching live thumbnails

Vindral automatically creates thumbnails during your live sessions. The thumbnails are available either via the API Client SDK (find more info in Web SDK docs) or via the global load balancer.

Fetching via Vindral load balancer​

Thumbnails are available via the global load balancer, giving users access to the thumbnails with the lowest possible latency.

Fetch by URL​

Response will automatically match the lowest resolution available if no width/height is requested.

https://lb.cdn.vindral.com/api/thumbnail?channelId=<channelId>

Constrain by the maximum width​

Response will match the closest resolution where image width <= width parameter.

https://lb.cdn.vindral.com/api/thumbnail?channelId=<channelId>&width=<width>

Constrain by the maximum width and height​

Response will match the closest resolution where image width <= width parameter && image height <= height parameter.

https://lb.cdn.vindral.com/api/thumbnail?channelId=<channelId>&width=<width>&height=<height>

Authenticated thumbnails​

Thumbnails require the same authentication as the channel. Specify the authentication token via a query parameter.

https://lb.cdn.vindral.com/api/thumbnail?channelId=<channelId>&auth.token=<token>

Cache​

Thumbnails are cached for 5 seconds, which is also reflected on their response headers.

Image update interval​

By default, thumbnails are updated every 5 seconds. Let us know if there is a need for higher frequency or disabling them.