Download Video

curl --request GET \
  --url 'https://api.mixroute.ai/v1/video/generations/download?id=video_xxx' \
  --header 'Authorization: Bearer sk-xxxxxxxxxx'

import requests

url = "https://api.mixroute.ai/v1/video/generations/download"
params = {"id": "video_xxx"}
headers = {"Authorization": "Bearer sk-xxxxxxxxxx"}

response = requests.get(url, params=params, headers=headers)
print(response.json())

import { writeFile } from "node:fs/promises";

const apiKey = process.env.MIXROUTE_API_KEY;
if (!apiKey) throw new Error("MIXROUTE_API_KEY is required");
const url = new URL("https://api.mixroute.ai/v1/video/generations/download");
url.searchParams.set("id", "TASK_ID");
const response = await fetch(url, {
  headers: { Authorization: "Bearer " + apiKey },
  signal: AbortSignal.timeout(120000),
});
if (!response.ok) throw new Error("Download HTTP error: " + response.status);
const data = await response.json();
if (data.success !== true || typeof data.base64 !== "string" || !data.base64) {
  throw new Error(data.message || "No downloadable video in response");
}
await writeFile("video.mp4", Buffer.from(data.base64, "base64"));

<?php
$client = new GuzzleHttp\Client();
$response = $client->get('https://api.mixroute.ai/v1/video/generations/download', [
    'headers' => [
        'Authorization' => 'Bearer sk-xxxxxxxxxx'
    ],
    'query' => ['id' => 'video_xxx']
]);
echo $response->getBody();

package main

import (
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.mixroute.ai/v1/video/generations/download?id=video_xxx", nil)
    req.Header.Set("Authorization", "Bearer sk-xxxxxxxxxx")
    http.DefaultClient.Do(req)
}

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.mixroute.ai/v1/video/generations/download?id=video_xxx"))
    .header("Authorization", "Bearer sk-xxxxxxxxxx")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI('https://api.mixroute.ai/v1/video/generations/download?id=video_xxx')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer sk-xxxxxxxxxx'

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

{
  "success": true,
  "generation_id": "video_xxx",
  "task_id": "video_xxx",
  "format": "mp4",
  "size": 15728640,
  "base64": "AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDE...",
  "data_url": "data:video/mp4;base64,AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDE..."
}

GET

video

generations

download

curl --request GET \
  --url 'https://api.mixroute.ai/v1/video/generations/download?id=video_xxx' \
  --header 'Authorization: Bearer sk-xxxxxxxxxx'

import requests

url = "https://api.mixroute.ai/v1/video/generations/download"
params = {"id": "video_xxx"}
headers = {"Authorization": "Bearer sk-xxxxxxxxxx"}

response = requests.get(url, params=params, headers=headers)
print(response.json())

import { writeFile } from "node:fs/promises";

const apiKey = process.env.MIXROUTE_API_KEY;
if (!apiKey) throw new Error("MIXROUTE_API_KEY is required");
const url = new URL("https://api.mixroute.ai/v1/video/generations/download");
url.searchParams.set("id", "TASK_ID");
const response = await fetch(url, {
  headers: { Authorization: "Bearer " + apiKey },
  signal: AbortSignal.timeout(120000),
});
if (!response.ok) throw new Error("Download HTTP error: " + response.status);
const data = await response.json();
if (data.success !== true || typeof data.base64 !== "string" || !data.base64) {
  throw new Error(data.message || "No downloadable video in response");
}
await writeFile("video.mp4", Buffer.from(data.base64, "base64"));

<?php
$client = new GuzzleHttp\Client();
$response = $client->get('https://api.mixroute.ai/v1/video/generations/download', [
    'headers' => [
        'Authorization' => 'Bearer sk-xxxxxxxxxx'
    ],
    'query' => ['id' => 'video_xxx']
]);
echo $response->getBody();

package main

import (
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.mixroute.ai/v1/video/generations/download?id=video_xxx", nil)
    req.Header.Set("Authorization", "Bearer sk-xxxxxxxxxx")
    http.DefaultClient.Do(req)
}

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.mixroute.ai/v1/video/generations/download?id=video_xxx"))
    .header("Authorization", "Bearer sk-xxxxxxxxxx")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI('https://api.mixroute.ai/v1/video/generations/download?id=video_xxx')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer sk-xxxxxxxxxx'

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

{
  "success": true,
  "generation_id": "video_xxx",
  "task_id": "video_xxx",
  "format": "mp4",
  "size": 15728640,
  "base64": "AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDE...",
  "data_url": "data:video/mp4;base64,AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDE..."
}

Introduction

The download video endpoint is used to retrieve completed video file data.

This endpoint is only supported by Sora 2 model. Other models (Veo, Doubao Seedance) return the video URL directly in the query task response, no additional download step required.

Authentication

Bearer Token, e.g., Bearer sk-xxxxxxxxxx

Query Parameters

string

required

Video ID, the task_id returned by the query task endpoint

cURL Example

curl -X GET "https://api.mixroute.ai/v1/video/generations/download?id=video_69095b4ce0048190893a01510c0c98b0" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

Response Example

{
  "success": true,
  "generation_id": "video_69095b4ce0048190893a01510c0c98b0",
  "task_id": "video_69095b4ce0048190893a01510c0c98b0",
  "format": "mp4",
  "size": 15728640,
  "base64": "AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAAB...",
  "data_url": "data:video/mp4;base64,AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAAB..."
}

Response Fields

Field	Type	Description
`success`	boolean	Whether the request was successful
`generation_id`	string	Generation ID (same as videoId)
`task_id`	string	Task ID
`format`	string	Video format (fixed to `"mp4"`)
`size`	number	Video file size (bytes)
`base64`	string	Base64 encoded video data
`data_url`	string	Data URL format video data, can be used directly in frontend `<video>` tag

Usage Guide

Using data_url in Frontend

The data_url field can be used directly in HTML <video> tag:

<video src="data:video/mp4;base64,AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAAB..." controls></video>

Download and Save File

Node.js (Server-Side)

Keep the MixRoute key on your server. Browser code should call your own backend, not embed the key. This endpoint returns JSON containing Base64, not raw MP4 bytes.

import { writeFile } from "node:fs/promises";

const apiKey = process.env.MIXROUTE_API_KEY;
if (!apiKey) throw new Error("MIXROUTE_API_KEY is required");
const url = new URL("https://api.mixroute.ai/v1/video/generations/download");
url.searchParams.set("id", "TASK_ID");
const response = await fetch(url, {
  headers: { Authorization: "Bearer " + apiKey },
  signal: AbortSignal.timeout(120000),
});
if (!response.ok) throw new Error("Download HTTP error: " + response.status);
const data = await response.json();
if (data.success !== true || typeof data.base64 !== "string" || !data.base64) {
  throw new Error(data.message || "No downloadable video in response");
}
await writeFile("video.mp4", Buffer.from(data.base64, "base64"));

Python Example

import base64
import os
from pathlib import Path
import requests

def download_video(task_id, output_path="video.mp4"):
    response = requests.get(
        "https://api.mixroute.ai/v1/video/generations/download",
        params={"id": task_id},
        headers={"Authorization": "Bearer " + os.environ["MIXROUTE_API_KEY"]},
        timeout=120,
    )
    response.raise_for_status()
    result = response.json()
    if result.get("success") is not True or not result.get("base64"):
        raise RuntimeError(result.get("message") or "No downloadable video in response")
    video = base64.b64decode(result["base64"], validate=True)
    Path(output_path).write_bytes(video)
    return output_path

if __name__ == "__main__":
    print(download_video("TASK_ID"))

Complete Workflow Example (Sora 2)

1. Submit Video Generation Task

curl -X POST "https://api.mixroute.ai/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "A cute kitten playing in the garden",
    "seconds": "4",
    "size": "720x1280"
  }'

Response:

{
  "task_id": "video_69095b4ce0048190893a01510c0c98b0",
  "status": "submitted",
  "format": "mp4"
}

2. Query Task Status (Poll Until Success)

curl -X GET "https://api.mixroute.ai/v1/video/generations/video_69095b4ce0048190893a01510c0c98b0" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

After the query reports a successful terminal status (succeeded, SUCCESS, or completed), proceed to the next step.

3. Download Video File

curl -X GET "https://api.mixroute.ai/v1/video/generations/download?id=video_69095b4ce0048190893a01510c0c98b0" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

Notes

The download endpoint returns Base64 encoded video data, suitable for direct display in frontend or saving
For large files, consider using streaming download or direct URL download
Video format is fixed to MP4

curl --request GET \
  --url 'https://api.mixroute.ai/v1/video/generations/download?id=video_xxx' \
  --header 'Authorization: Bearer sk-xxxxxxxxxx'

import requests

url = "https://api.mixroute.ai/v1/video/generations/download"
params = {"id": "video_xxx"}
headers = {"Authorization": "Bearer sk-xxxxxxxxxx"}

response = requests.get(url, params=params, headers=headers)
print(response.json())

import { writeFile } from "node:fs/promises";

const apiKey = process.env.MIXROUTE_API_KEY;
if (!apiKey) throw new Error("MIXROUTE_API_KEY is required");
const url = new URL("https://api.mixroute.ai/v1/video/generations/download");
url.searchParams.set("id", "TASK_ID");
const response = await fetch(url, {
  headers: { Authorization: "Bearer " + apiKey },
  signal: AbortSignal.timeout(120000),
});
if (!response.ok) throw new Error("Download HTTP error: " + response.status);
const data = await response.json();
if (data.success !== true || typeof data.base64 !== "string" || !data.base64) {
  throw new Error(data.message || "No downloadable video in response");
}
await writeFile("video.mp4", Buffer.from(data.base64, "base64"));

<?php
$client = new GuzzleHttp\Client();
$response = $client->get('https://api.mixroute.ai/v1/video/generations/download', [
    'headers' => [
        'Authorization' => 'Bearer sk-xxxxxxxxxx'
    ],
    'query' => ['id' => 'video_xxx']
]);
echo $response->getBody();

package main

import (
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.mixroute.ai/v1/video/generations/download?id=video_xxx", nil)
    req.Header.Set("Authorization", "Bearer sk-xxxxxxxxxx")
    http.DefaultClient.Do(req)
}

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.mixroute.ai/v1/video/generations/download?id=video_xxx"))
    .header("Authorization", "Bearer sk-xxxxxxxxxx")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI('https://api.mixroute.ai/v1/video/generations/download?id=video_xxx')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer sk-xxxxxxxxxx'

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

{
  "success": true,
  "generation_id": "video_xxx",
  "task_id": "video_xxx",
  "format": "mp4",
  "size": 15728640,
  "base64": "AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDE...",
  "data_url": "data:video/mp4;base64,AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDE..."
}

Popular Models

OpenAI SDK Usage

System API

Text Series

Embedding Series

Image Series

Video Series

Others

Introduction

Authentication

Query Parameters

cURL Example

Response Example

Response Fields

Usage Guide

Using data_url in Frontend

Download and Save File

Node.js (Server-Side)

Python Example

Complete Workflow Example (Sora 2)

1. Submit Video Generation Task

2. Query Task Status (Poll Until Success)

3. Download Video File

Notes

​Introduction

​Authentication

​Query Parameters

​cURL Example

​Response Example

​Response Fields

​Usage Guide

​Using data_url in Frontend

​Download and Save File

​Node.js (Server-Side)

​Python Example

​Complete Workflow Example (Sora 2)

​1. Submit Video Generation Task

​2. Query Task Status (Poll Until Success)

​3. Download Video File

​Notes

Introduction

Authentication

Query Parameters

cURL Example

Response Example

Response Fields

Usage Guide

Using data_url in Frontend

Download and Save File

Node.js (Server-Side)

Python Example

Complete Workflow Example (Sora 2)

1. Submit Video Generation Task

2. Query Task Status (Poll Until Success)

3. Download Video File

Notes