The video object
The video object is a JSON object with the following properties:
{
"id": string,
"status": "COMPLETE" | "PROCESSING" | "NO_FILE" | "FAILED",
"visibility": "public" | "private",
"title": string,
"slug": string,
"duration": number,
"fps": number,
"orientation": "landscape" | "portrait",
"sourceFolder": string,
"src": {
"thumbnailUrl": string,
"thumbnailUrlOriginal": string,
"filename": string,
"abr": {
"resolution": "auto",
"description": "Adaptive Bitrate Streaming (ABR)",
"url": string, // .m3u8 playlist file
"maxWidth": number,
"maxHeight": number
},
"hls": [
{
"name": "2160p" | "1440p" | "1080p" | "720p" | "480p" | "360p" | "240p",
"url": string, // .m3u8 playlist file
"width": number,
"height": number
},
[...]
],
"mp4": [
{
"name": "2160p" | "1440p" | "1080p" | "720p" | "480p" | "360p" | "240p",
"url": string, // .mp4 file
"width": number,
"height": number
},
[...]
]
},
"subtitles": [
{
"language": "en" | "de" | "it" | "fr" | "...",
"content": string,
"filename": string,
"url": string,
"id": string
},
[...]
],
"categories": [
{
"id": string,
"title": string,
"slug": string,
},
[...]
],
"tags": [
{
"id": string,
"title": string,
"slug": string,
},
[...]
],
"createdAt": Date,
"updatedAt": Date
}
Video sources
Video src arrays
The hls
and mp4
arrays contain a list of all available video sources for the video. The arrays are ordered by quality, starting with the highest quality. Video variants are generated up to the input videos resolution. So an uploaded 1080p video will not have a 2160p and 1440p variant.
{
"name": "2160p" | "1440p" | "1080p" | "720p" | "480p" | "360p" | "240p",
"url": string,
"width": number,
"height": number
}
Adaptive Bitrate Streaming (ABR)
If you want to provide your videos via adaptive bitrate streaming (abbreviated ABR), you can do so by using the src.abr.url
as your video source. The playlist file provides all provided video qualities listed in the src.hls
array.