WIwithchima
Clips

Get a source thumbnail or animated preview

Changed on

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

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

  • ac47c99c144fRevision changes
    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

  • 6b1132ef42fbRevision changes
    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status