動画のダウンロード

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..."
}

はじめに

動画ダウンロードエンドポイントは、生成が完了した動画のファイルデータを取得するために使用します。

このエンドポイントに対応しているのはSora 2モデルのみです。ほかのモデル（Veo、Doubao Seedance）は、タスク照会のレスポンスで動画URLを直接返すため、追加のダウンロード手順は不要です。

認証

Bearerトークン。例: Bearer sk-xxxxxxxxxx

クエリパラメータ

string

必須

動画ID。タスク照会エンドポイントが返すtask_idです

cURLの例

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

レスポンス例

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

レスポンスフィールド

フィールド	型	説明
`success`	boolean	リクエストが成功したかどうか
`generation_id`	string	生成ID（videoIdと同じ）
`task_id`	string	タスクID
`format`	string	動画形式（`"mp4"`に固定）
`size`	number	動画ファイルのサイズ（バイト）
`base64`	string	Base64エンコードされた動画データ
`data_url`	string	Data URL形式の動画データ。フロントエンドの`<video>`タグで直接使用できます

利用ガイド

フロントエンドでdata_urlを使用する

data_urlフィールドは、HTMLの<video>タグで直接使用できます。

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

ファイルのダウンロードと保存

Node.js（サーバー側）

MixRouteキーはサーバー側に保持してください。ブラウザーのコードにはキーを埋め込まず、ご自身のバックエンドを呼び出してください。このエンドポイントは、生のMP4バイト列ではなく、Base64を含む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"));

Pythonの例

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"))

ワークフロー全体の例（Sora 2）

1. 動画生成タスクを送信

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"
  }'

レスポンス：

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

2. タスクの状態を照会（成功するまでポーリング）

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

照会で成功の終端ステータス（succeeded、SUCCESS、またはcompleted）が報告されたら、次のステップに進みます。

3. 動画ファイルをダウンロード

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

注意事項

ダウンロードエンドポイントはBase64でエンコードされた動画データを返します。フロントエンドでの直接表示や保存に適しています
大きなファイルには、ストリーミングダウンロードまたはURLからの直接ダウンロードを検討してください
動画形式は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..."
}

人気モデル

OpenAI SDKの使い方

システムAPI

テキストシリーズ

意思決定モデル

埋め込みシリーズ

画像シリーズ

動画シリーズ

その他

動画のダウンロード

はじめに

認証

クエリパラメータ

cURLの例

レスポンス例

レスポンスフィールド

利用ガイド

フロントエンドでdata_urlを使用する

ファイルのダウンロードと保存

Node.js（サーバー側）

Pythonの例

ワークフロー全体の例（Sora 2）

1. 動画生成タスクを送信

2. タスクの状態を照会（成功するまでポーリング）

3. 動画ファイルをダウンロード

注意事項

​はじめに

​認証

​クエリパラメータ

​cURLの例

​レスポンス例

​レスポンスフィールド

​利用ガイド

​フロントエンドでdata_urlを使用する

​ファイルのダウンロードと保存

​Node.js（サーバー側）

​Pythonの例

​ワークフロー全体の例（Sora 2）

​1. 動画生成タスクを送信

​2. タスクの状態を照会（成功するまでポーリング）

​3. 動画ファイルをダウンロード

​注意事項

はじめに

認証

クエリパラメータ

cURLの例

レスポンス例

レスポンスフィールド

利用ガイド

フロントエンドでdata_urlを使用する

ファイルのダウンロードと保存

Node.js（サーバー側）

Pythonの例

ワークフロー全体の例（Sora 2）

1. 動画生成タスクを送信

2. タスクの状態を照会（成功するまでポーリング）

3. 動画ファイルをダウンロード

注意事項