WIwithchima
Tella Motion

Get a frame or preview of a Tella Motion document

Changed on

Returns a signed CDN URL for a still image (jpg/png/webp) or animated preview (gif/mp4) of the document on its own, at a time on its own clock: any document you can edit, also one no video plays yet. Width and height follow the document's canvas; a time at or past its end shows its end. By default returns a 302 redirect — set ?response=json to get {url} JSON instead.

get/v1/motion/documents/{id}/thumbnail

Request

Path parameters

idstring required

Tella Motion document ID (ffd_…), from GET /v1/motion/documents.

Query parameters

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

Output format. Defaults to jpg.

Example:jpg
startTimeMsinteger

Frame offset in ms on the playback timeline (cuts applied) — clip-relative for the clip thumbnail, video-relative (cumulative across clips) for the video thumbnail. Defaults to 0.

Example:1000
durationMsinteger

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

Example:3000
fpsnumber

Frame rate for MP4 previews. Must be 1, 2, 5, 10, or 30. Defaults to 30.

Example:10
widthinteger

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

Example:1280
heightinteger

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

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

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

Example:json

Response

Returned when ?response=json is set

urlstring uri required

Changes