Set a video's thumbnail
Sets the video’s thumbnail from either an uploaded image or a frame of the video itself. Provide exactly one of sourceId (an image source from POST /v1/sources with kind: "image" — upload the image bytes to its uploadUrl first) or inpointMs (a time on the video’s playback timeline). Setting one mode clears the other.
Authorizations
API key obtained from your Tella account settings
Path Parameters
Unique video identifier
"vid_abc123def456"
Body
Request body for setting a video's thumbnail. Provide exactly one of sourceId (uploaded image) or inpointMs (frame from the video).
Pick a video frame as the thumbnail: time in ms on the video's playback timeline (cuts applied, cumulative across clips). Clears any previously uploaded thumbnail image. Mutually exclusive with sourceId.
0 <= x <= 90071992547409914500
Use an uploaded image as the thumbnail. Source ID from POST /v1/sources (kind: 'image'); upload the image bytes to the source's uploadUrl first. Mutually exclusive with inpointMs.
1"su_abc123def456"
Response
Thumbnail set successfully
The thumbnail that was set
CDN URL of the uploaded thumbnail image. Only present when the thumbnail was set from a sourceId.
"https://ucarecdn.com/12345678-abcd-4ef0-9012-3456789abcde/"
The thumbnail frame time in ms. Only present when the thumbnail was set from an inpointMs.
-9007199254740991 <= x <= 90071992547409914500