Sources

Get a thumbnail of a source on no clip

Get a thumbnail or animated preview of a streaming upload source owned by the caller or their workspace, without a video or clip — for a source that isn't on any clip yet. startTimeMs is relative to the 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. By default returns a 302 redirect — set ?response=json to get {url} JSON instead.

get/v1/sources/{sourceId}/thumbnail

Request

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

Path parameters

sourceIdstring required

Streaming upload source identifier

Example:su_abc123def456

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.