MiniMax H3 Wiki

• MiniMax プラットフォームのダッシュボードを開き、API キーを作成します。
• キーをソースコードに直接記述せず、環境変数に保存します。
• すべての API リクエストで、Authorization ヘッダーを通じてキーを送信します。

export MINIMAX_API_KEY="YOUR_API_KEY"

curl --request POST \
  --url "https://api.minimax.io/v1/video_generation" \
  --header "Authorization: Bearer $MINIMAX_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "MiniMax-H3",
    "prompt": "A cinematic tracking shot of a futuristic city at sunrise, with natural traffic sounds and distant dialogue.",
    "duration": 6,
    "resolution": "768P"
  }'

Result: API から返された task_id を保存します。リクエストが受け付けられた後も、動画のレンダリングは非同期で続行されます。

import os
import time
import requests

API_KEY = os.environ["MINIMAX_API_KEY"]
BASE_URL = "https://api.minimax.io/v1"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

payload = {
    "model": "MiniMax-H3",
    "prompt": "A premium perfume bottle rotating on black glass, dramatic studio lighting and synchronized ambient sound.",
    "duration": 6,
    "resolution": "768P",
}

create_response = requests.post(
    f"{BASE_URL}/video_generation",
    headers=HEADERS,
    json=payload,
    timeout=60,
)
create_response.raise_for_status()
task_id = create_response.json()["task_id"]

while True:
    query_response = requests.get(
        f"{BASE_URL}/query/video_generation",
        headers=HEADERS,
        params={"task_id": task_id},
        timeout=30,
    )
    query_response.raise_for_status()
    task = query_response.json()
    status = task.get("status")

    if status == "Success":
        file_id = task["file_id"]
        print("Completed:", file_id)
        break

    if status == "Fail":
        raise RuntimeError(task.get("error_message", "Video generation failed"))

    time.sleep(10)

Result: タスクが準備中、キュー待ち、または処理中の間はポーリングを続けます。ステータスが Success または Fail になったら停止します。

const apiKey = process.env.MINIMAX_API_KEY;
const baseUrl = "https://api.minimax.io/v1";

async function getVideo(taskId) {
  const queryResponse = await fetch(
    `${baseUrl}/query/video_generation?task_id=${encodeURIComponent(taskId)}`,
    {
      headers: { Authorization: `Bearer ${apiKey}` }
    }
  );

  if (!queryResponse.ok) {
    throw new Error(`Query failed with HTTP ${queryResponse.status}`);
  }

  const task = await queryResponse.json();
  if (task.status !== "Success") return task;

  const fileResponse = await fetch(
    `${baseUrl}/files/retrieve?file_id=${encodeURIComponent(task.file_id)}`,
    {
      headers: { Authorization: `Bearer ${apiKey}` }
    }
  );

  if (!fileResponse.ok) {
    throw new Error(`File retrieval failed with HTTP ${fileResponse.status}`);
  }

  const file = await fileResponse.json();
  return {
    status: task.status,
    fileId: task.file_id,
    downloadUrl: file.file?.download_url || file.download_url
  };
}

Result: 返されたダウンロード URL は速やかに使用し、必要に応じて完成した動画を永続的なアプリケーションストレージにコピーします。

export MINIMAX_API_KEY="YOUR_API_KEY"

minimax --help
minimax video --help
minimax video create --model MiniMax-H3 --prompt "A cinematic product reveal" --resolution 768P --duration 6
minimax video query --task-id "TASK_ID"

Result: CLI は、直接 HTTP 統合の場合と同じ API キーおよび非同期タスクフローを使用します。