Clips

Get a source thumbnail or animated preview

Get a thumbnail of a source. If you pass width/height, the aspect ratio must match the source's native ratio. Omit both to default to the source's native size.

get/v1/videos/{id}/clips/{clipId}/sources/{sourceId}/thumbnail

Request

  • Base URL: https://api.tella.com
  • URL: https://api.tella.com/v1/videos/{id}/clips/{clipId}/sources/{sourceId}/thumbnail
  • Auth: HTTP bearer

Path parameters

idstring required

Video ID

clipIdstring required

Clip ID

sourceIdstring required

Source ID

Query parameters

format'jpg' | 'png' | 'webp' | 'gif' | 'mp4'

Output format. Defaults to jpg. Image sources support only still thumbnails (jpg, png or webp); gif and mp4 return a 400 error.

Example:jpg
startTimeMsinteger

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

Example:1000
durationMsinteger

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

Example:3000
widthinteger

Output width in pixels. The thumbnail keeps the source's aspect ratio; a missing side is derived from it.

Example:1280
heightinteger

Output height in pixels. Derived from the source's aspect ratio when omitted.

Example:720
'true'
OR
'false'
response'json'

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

Response

Returned when ?response=json is set

urlstring uri required

Changes

No recorded changes to this operation across all 1 revision of this API.