Download Timeline Video

Download compiled timeline

curl --request POST \
  --url https://api.videodb.io/timeline_v2/download \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "timeline_id": "timeline-12345",
  "format": "mp4",
  "quality": "high"
}
'

const options = {
  method: 'POST',
  headers: {'x-access-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({timeline_id: 'timeline-12345', format: 'mp4', quality: 'high'})
};

fetch('https://api.videodb.io/timeline_v2/download', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.videodb.io/timeline_v2/download",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'timeline_id' => 'timeline-12345',
    'format' => 'mp4',
    'quality' => 'high'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-access-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.videodb.io/timeline_v2/download"

	payload := strings.NewReader("{\n  \"timeline_id\": \"timeline-12345\",\n  \"format\": \"mp4\",\n  \"quality\": \"high\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-access-token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.videodb.io/timeline_v2/download")
  .header("x-access-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"timeline_id\": \"timeline-12345\",\n  \"format\": \"mp4\",\n  \"quality\": \"high\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.videodb.io/timeline_v2/download")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"timeline_id\": \"timeline-12345\",\n  \"format\": \"mp4\",\n  \"quality\": \"high\"\n}"

response = http.request(request)
puts response.read_body

$headers=@{}
$headers.Add("x-access-token", "<api-key>")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://api.videodb.io/timeline_v2/download' -Method POST -Headers $headers -ContentType 'application/json' -Body '{
  "timeline_id": "timeline-12345",
  "format": "mp4",
  "quality": "high"
}'

import Foundation

let parameters = [
  "timeline_id": "timeline-12345",
  "format": "mp4",
  "quality": "high"
] as [String : Any?]

let postData = try JSONSerialization.data(withJSONObject: parameters, options: [])

let url = URL(string: "https://api.videodb.io/timeline_v2/download")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.timeoutInterval = 10
request.allHTTPHeaderFields = [
  "x-access-token": "<api-key>",
  "Content-Type": "application/json"
]
request.httpBody = postData

let (data, _) = try await URLSession.shared.data(for: request)
print(String(decoding: data, as: UTF8.self))

using RestSharp;


var options = new RestClientOptions("https://api.videodb.io/timeline_v2/download");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("x-access-token", "<api-key>");
request.AddJsonBody("{\n  \"timeline_id\": \"timeline-12345\",\n  \"format\": \"mp4\",\n  \"quality\": \"high\"\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

using RestSharp;


var options = new RestClientOptions("https://api.videodb.io/timeline_v2/download");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("x-access-token", "<api-key>");
request.AddJsonBody("{\n  \"timeline_id\": \"timeline-12345\",\n  \"format\": \"mp4\",\n  \"quality\": \"high\"\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

const options = {
  method: 'POST',
  headers: {'x-access-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({timeline_id: 'timeline-12345', format: 'mp4', quality: 'high'})
};

fetch('https://api.videodb.io/timeline_v2/download', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.videodb.io/timeline_v2/download");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "x-access-token: <api-key>");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\n  \"timeline_id\": \"timeline-12345\",\n  \"format\": \"mp4\",\n  \"quality\": \"high\"\n}");

CURLcode ret = curl_easy_perform(hnd);

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.videodb.io/timeline_v2/download");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "x-access-token: <api-key>");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\n  \"timeline_id\": \"timeline-12345\",\n  \"format\": \"mp4\",\n  \"quality\": \"high\"\n}");

CURLcode ret = curl_easy_perform(hnd);

val client = OkHttpClient()

val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{\n  \"timeline_id\": \"timeline-12345\",\n  \"format\": \"mp4\",\n  \"quality\": \"high\"\n}")
val request = Request.Builder()
  .url("https://api.videodb.io/timeline_v2/download")
  .post(body)
  .addHeader("x-access-token", "<api-key>")
  .addHeader("Content-Type", "application/json")
  .build()

val response = client.newCall(request).execute()

{
  "success": true,
  "status": "processing",
  "data": {
    "id": "job-123",
    "output_url": "https://api.videodb.io/async-response/job-123"
  }
}

POST

timeline_v2

download

Download compiled timeline

curl --request POST \
  --url https://api.videodb.io/timeline_v2/download \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "timeline_id": "timeline-12345",
  "format": "mp4",
  "quality": "high"
}
'

const options = {
  method: 'POST',
  headers: {'x-access-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({timeline_id: 'timeline-12345', format: 'mp4', quality: 'high'})
};

fetch('https://api.videodb.io/timeline_v2/download', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.videodb.io/timeline_v2/download",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'timeline_id' => 'timeline-12345',
    'format' => 'mp4',
    'quality' => 'high'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-access-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.videodb.io/timeline_v2/download"

	payload := strings.NewReader("{\n  \"timeline_id\": \"timeline-12345\",\n  \"format\": \"mp4\",\n  \"quality\": \"high\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-access-token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.videodb.io/timeline_v2/download")
  .header("x-access-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"timeline_id\": \"timeline-12345\",\n  \"format\": \"mp4\",\n  \"quality\": \"high\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.videodb.io/timeline_v2/download")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"timeline_id\": \"timeline-12345\",\n  \"format\": \"mp4\",\n  \"quality\": \"high\"\n}"

response = http.request(request)
puts response.read_body

$headers=@{}
$headers.Add("x-access-token", "<api-key>")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://api.videodb.io/timeline_v2/download' -Method POST -Headers $headers -ContentType 'application/json' -Body '{
  "timeline_id": "timeline-12345",
  "format": "mp4",
  "quality": "high"
}'

import Foundation

let parameters = [
  "timeline_id": "timeline-12345",
  "format": "mp4",
  "quality": "high"
] as [String : Any?]

let postData = try JSONSerialization.data(withJSONObject: parameters, options: [])

let url = URL(string: "https://api.videodb.io/timeline_v2/download")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.timeoutInterval = 10
request.allHTTPHeaderFields = [
  "x-access-token": "<api-key>",
  "Content-Type": "application/json"
]
request.httpBody = postData

let (data, _) = try await URLSession.shared.data(for: request)
print(String(decoding: data, as: UTF8.self))

using RestSharp;


var options = new RestClientOptions("https://api.videodb.io/timeline_v2/download");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("x-access-token", "<api-key>");
request.AddJsonBody("{\n  \"timeline_id\": \"timeline-12345\",\n  \"format\": \"mp4\",\n  \"quality\": \"high\"\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

using RestSharp;


var options = new RestClientOptions("https://api.videodb.io/timeline_v2/download");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("x-access-token", "<api-key>");
request.AddJsonBody("{\n  \"timeline_id\": \"timeline-12345\",\n  \"format\": \"mp4\",\n  \"quality\": \"high\"\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

const options = {
  method: 'POST',
  headers: {'x-access-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({timeline_id: 'timeline-12345', format: 'mp4', quality: 'high'})
};

fetch('https://api.videodb.io/timeline_v2/download', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.videodb.io/timeline_v2/download");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "x-access-token: <api-key>");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\n  \"timeline_id\": \"timeline-12345\",\n  \"format\": \"mp4\",\n  \"quality\": \"high\"\n}");

CURLcode ret = curl_easy_perform(hnd);

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.videodb.io/timeline_v2/download");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "x-access-token: <api-key>");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\n  \"timeline_id\": \"timeline-12345\",\n  \"format\": \"mp4\",\n  \"quality\": \"high\"\n}");

CURLcode ret = curl_easy_perform(hnd);

val client = OkHttpClient()

val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{\n  \"timeline_id\": \"timeline-12345\",\n  \"format\": \"mp4\",\n  \"quality\": \"high\"\n}")
val request = Request.Builder()
  .url("https://api.videodb.io/timeline_v2/download")
  .post(body)
  .addHeader("x-access-token", "<api-key>")
  .addHeader("Content-Type", "application/json")
  .build()

val response = client.newCall(request).execute()

{
  "success": true,
  "status": "processing",
  "data": {
    "id": "job-123",
    "output_url": "https://api.videodb.io/async-response/job-123"
  }
}

Download a generated timeline stream as a downloadable video file in MP4 format. After creating a timeline, use this endpoint to export it for sharing or offline use.

import videodb
from videodb.editor import Timeline, Track, Clip, VideoAsset

conn = videodb.connect(api_key="your_api_key")

# Create and generate a timeline (see Create Timeline v2)
timeline = Timeline(conn)
track = Track()
video_asset = VideoAsset(id="m-abc123def", start=0)
clip = Clip(asset=video_asset, duration=10)
track.add_clip(0, clip)
timeline.add_track(track)

# Generate the stream
stream_url = timeline.generate_stream()

# Download the timeline as a video file
download_result = timeline.download_stream(stream_url)

print(f"Download URL: {download_result.get('download_url')}")
print(f"Status: {download_result.get('status')}")

import { connect, EditorTimeline, Track, Clip, EditorVideoAsset } from 'videodb';

const conn = await connect({ apiKey: 'your_api_key' });

// Create and generate a timeline (see Create Timeline v2)
const timeline = new EditorTimeline(conn);
const track = new Track();
const videoAsset = new EditorVideoAsset({ id: 'm-abc123def', start: 0 });
const clip = new Clip({ asset: videoAsset, duration: 10 });
track.addClip(0, clip);
timeline.addTrack(track);

// Generate the stream
const streamUrl = await timeline.generateStream();

// Download the timeline as a video file
const downloadResult = await timeline.downloadStream(streamUrl);

console.log(`Download URL: ${downloadResult.downloadUrl}`);
console.log(`Status: ${downloadResult.status}`);

Download requires a valid stream URL from a generated timeline
Downloads are processed asynchronously and return a download URL
Video format is MP4 with standard codec support
Downloaded files can be shared, archived, or used in other applications
Check the status field to track download progress

Create Timeline v2

Generate timeline to download

Connection API

API authentication and connection

Authorizations

x-access-token

string

header

required

API key for authentication (sk-xxx format)

Body

application/json

timeline_id

string

required

Example:

"timeline-12345"

format

enum<string>

Available options:

mp4,

webm,

avi

Example:

"mp4"

quality

enum<string>

Available options:

low,

medium,

high

Example:

"high"

Response

200 - application/json

Download initiated

success

boolean

Example:

true

status

enum<string>

Available options:

processing,

done,

failed

Example:

"processing"

data

object

Show child attributes

⌘I

Overview

Authentication

Collections

Videos

Streaming & Playback

Transcription

Search V2 & Ask

Indexing & Search

Scene & Frame Analysis

Advanced Operations

Audio

Images

AI Generation

Timeline & Compilation

Billing

Downloads

Utilities

Assets

Editor

Transcode

Meeting

Capture

RTStream

RTStream Transcription

RTStream Scene Indexing

RTStream Events & Alerts

Create Timeline v2

Connection API

Authorizations

Body

Response