Sign in
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

Path parameters

sourceIdstring required

Streaming upload source identifier

Example:su_abc123def456

Streaming upload source identifier

Query parameters

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

Output format. Defaults to jpg.

Example:jpg

Output format. Defaults to jpg.

startTimeMsinteger

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

Example:1000

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

durationMsinteger

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

Example:3000

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

widthinteger

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

Example:1280

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

heightinteger

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

Example:720

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

'true'
OR
'false'

Suggest a download disposition on the signed URL.

response'json'

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

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

Response

Returned when ?response=json is set

urlstring uri required

Changes

Changed in 2 of the 19 revisions of this API.91

  • ac47c99c144f9See the full diff
    • ●

      added the new edit_conflict enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new edit_conflict enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new edit_conflict enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new edit_conflict enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new edit_conflict enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new edit_conflict enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new edit_conflict enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new edit_conflict enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new edit_conflict enum value to the response property for the response status

      response-property-enum-value-added

  • b25e530cdcc51See the full diff
    • ○

      endpoint added

      endpoint-added

Of the 19 revisions, 1 has no diff computed.