Skip to main content
GET
/
v1
/
videos
/
{id}
/
thumbnail
Get a video thumbnail or animated preview
curl --request GET \
  --url https://api.tella.com/v1/videos/{id}/thumbnail \
  --header 'Authorization: Bearer <token>'
{
  "url": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

​
id
string
required

Unique video identifier

Example:

"vid_abc123def456"

Query Parameters

​
format
enum<string>

Output format. Defaults to jpg.

Available options:
jpg,
png,
webp,
gif,
mp4
Example:

"jpg"

​
inpointMs
integer

Frame offset in ms from the clip's start. Defaults to 0.

Required range: 0 <= x <= 9007199254740991
Example:

1000

​
durationMs
integer

Duration of the animated preview in ms. Only valid when format is gif or mp4.

Required range: x <= 9007199254740991
Example:

3000

​
width
integer

Output width in pixels

Required range: x <= 9007199254740991
Example:

1280

​
height
integer

Output height in pixels

Required range: x <= 9007199254740991
Example:

720

​
download

Suggest a download disposition on the signed URL.

Available options:
true
Example:

"false"

​
response
enum<string>

Set to 'json' to receive {url} instead of the default 302 redirect.

Available options:
json
Example:

"json"

Response

Returned when ?response=json is set

Signed CDN URL for the requested thumbnail. Returned only when ?response=json is set; otherwise the endpoint redirects to the URL with a 302.

​
url
string<uri>
required