MiniMax H3 위키

• 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 키 및 비동기 작업 흐름을 사용합니다.