Videos
Get video information
Changed onReturns detailed information about a video including chapters, transcript, and thumbnails
get/v1/videos/{id}
Request
- Base URLhttps://api.tella.com
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
idstring required
Unique video identifier
Example:vid_abc123def456
Response
OK
Example response
{
"video": {
"aspectRatio": "16:9",
"backgroundMusic": {
"durationMs": 180036,
"name": "Calm Product Tour",
"url": "https://ucarecdn.com/example-track/",
"volume": 0.2
},
"chapters": [
{
"description": "Overview of what we'll cover",
"title": "Introduction"
}
],
"clipIds": [
"cl_abc123",
"cl_def456"
],
"createdAt": "2024-01-15T10:30:00.000Z",
"description": "Learn how to create and share your first video",
"dimensions": {
"height": 1080,
"width": 1920
},
"durationSeconds": 125.5,
"exports": [
{
"downloadUrl": "https://cdn.tella.tv/exports/vid_abc123/video.mp4",
"exportId": "Export-Story-vid_abc123def456/2026-01-15T10:00:00Z/Story/1920x1080/30FPS",
"progress": 100,
"status": "completed",
"updatedAt": "2024-01-15T15:00:00.000Z"
}
],
"id": "vid_abc123def456",
"links": {
"embedPage": "https://www.tella.tv/video/vid_abc123def456/embed",
"viewPage": "https://www.tella.tv/video/vid_abc123def456/view"
},
"name": "Getting Started with Tella",
"playlistIds": [
"pl_abc123",
"pl_def456"
],
"settings": {
"allowedEmbedDomains": [
"example.com",
"mysite.org"
],
"callToAction": {
"url": "https://docs.tella.com/help"
},
"captionFontFamily": "Inter",
"captionFontSize": 64,
"captionFontWeight": 500,
"captionGrouping": "chunked",
"captionLinesPerBlock": 1,
"captionSize": "medium",
"captionStyle": {
"activeWordTextColor": "#5E51F8FF",
"backgroundColor": "#5E51F8FF",
"highlightColor": "#5E51F8FF",
"outlineColor": "#5E51F8FF",
"shadowColor": "#5E51F8FF",
"textColor": "#5E51F8FF"
},
"captionsDefaultEnabled": true,
"commentsEnabled": true,
"creatorEnabled": true,
"cursor": {
"size": 3.05,
"style": "macTahoe",
"tiltStrength": 0.5
},
"customThumbnailURL": "https://example.com/custom-thumbnail.jpg",
"defaultClipTransition": "smooth",
"defaultPlaybackRate": 1,
"downloadsEnabled": true,
"eyeContact": {
"cameras": 1,
"camerasReady": 1,
"enabled": true,
"status": "ready"
},
"keystrokes": {
"alignment": "center",
"animation": {
"intro": {
"durationMs": 500,
"easing": {
"bezier": [
0.25,
0.1,
0.25,
1
],
"curve": "slow_down",
"intensity": 0.5,
"spring": {
"damping": 12,
"mass": 1,
"stiffness": 200
}
},
"moveY": -0.5,
"preset": "slide_up",
"scale": 1,
"text": {
"delayMs": 100,
"order": "forward",
"smoothing": "linear",
"unit": "words"
}
},
"motionBlur": true,
"outro": {
"durationMs": 500,
"easing": {
"bezier": [
0.25,
0.1,
0.25,
1
],
"curve": "slow_down",
"intensity": 0.5,
"spring": {
"damping": 12,
"mass": 1,
"stiffness": 200
}
},
"moveY": -0.5,
"preset": "slide_up",
"scale": 1,
"text": {
"delayMs": 100,
"order": "forward",
"smoothing": "linear",
"unit": "words"
}
},
"textIntro": {
"durationMs": 500,
"easing": {
"bezier": [
0.25,
0.1,
0.25,
1
],
"curve": "slow_down",
"intensity": 0.5,
"spring": {
"damping": 12,
"mass": 1,
"stiffness": 200
}
},
"moveY": -0.5,
"preset": "slide_up",
"scale": 1,
"text": {
"delayMs": 100,
"order": "forward",
"smoothing": "linear",
"unit": "words"
}
},
"textOutro": {
"durationMs": 500,
"easing": {
"bezier": [
0.25,
0.1,
0.25,
1
],
"curve": "slow_down",
"intensity": 0.5,
"spring": {
"damping": 12,
"mass": 1,
"stiffness": 200
}
},
"moveY": -0.5,
"preset": "slide_up",
"scale": 1,
"text": {
"delayMs": 100,
"order": "forward",
"smoothing": "linear",
"unit": "words"
}
}
},
"colors": {
"background": "#FFFFFF",
"keyBackground": "#FFFFFF",
"keyText": "#FFFFFF"
},
"displayDurationMs": 1000,
"enabled": true,
"filter": "shortcuts",
"size": 1,
"style": "keycap",
"typing": "words"
},
"layoutAnimationStyle": "moderate",
"linkScope": "org",
"microphoneVolume": 1,
"motionBlur": true,
"motionBlurAmount": 1,
"publishDateEnabled": true,
"searchEngineIndexingEnabled": true,
"secondaryCallToAction": {
"url": "https://docs.tella.com/help"
},
"shrinkCameraDuringZooms": true,
"studioSoundLevel": "off",
"subtitlesEnabled": true,
"systemAudioVolume": 1,
"thumbnailInpointMs": 12000,
"transcriptsEnabled": true,
"viewCountEnabled": true,
"workspaceCallToAction": {
"url": "https://docs.tella.com/help"
},
"workspaceSecondaryCallToAction": {
"url": "https://docs.tella.com/help"
},
"zoomAnimationStyle": "moderate"
},
"thumbnails": {
"large": {
"gif": "https://cdn.tella.tv/thumbnails/vid_abc123/640x360.gif",
"jpg": "https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.jpg",
"mp4": "https://cdn.tella.tv/thumbnails/vid_abc123/640x360.mp4",
"webp": "https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.webp"
},
"medium": {
"gif": "https://cdn.tella.tv/thumbnails/vid_abc123/640x360.gif",
"jpg": "https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.jpg",
"mp4": "https://cdn.tella.tv/thumbnails/vid_abc123/640x360.mp4",
"webp": "https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.webp"
},
"small": {
"gif": "https://cdn.tella.tv/thumbnails/vid_abc123/640x360.gif",
"jpg": "https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.jpg",
"mp4": "https://cdn.tella.tv/thumbnails/vid_abc123/640x360.mp4",
"webp": "https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.webp"
},
"xl": {
"gif": "https://cdn.tella.tv/thumbnails/vid_abc123/640x360.gif",
"jpg": "https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.jpg",
"mp4": "https://cdn.tella.tv/thumbnails/vid_abc123/640x360.mp4",
"webp": "https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.webp"
}
},
"transcript": {
"language": "en",
"sentences": [
{
"endSeconds": 2.3,
"startSeconds": 0.5,
"text": "Hello and welcome to this tutorial."
}
],
"status": "ready",
"text": "Hello and welcome to this tutorial..."
},
"updatedAt": "2024-01-15T14:45:00.000Z",
"views": 1234
}
}Changes
- info
added the optional property
//////to the response with the status - info
added the optional property
///////////to the response with the status - info
added the required property
//////to the response with the status
- info
- info
added the optional property
////////to the response with the status - info
added the optional property
////////to the response with the status - info
added the optional property
////////to the response with the status - info
added the optional property
////////to the response with the status - info
added the optional property
////////to the response with the status
- info