MiniMax H3(Hailuo) 비디오 API: 요금과 사용법

export LAOZHANG_API_KEY="your-laozhang-api-key"
export BASE_URL="https://api.laozhang.ai"

curl -s -X POST "$BASE_URL/hailuo/v2/video_generation" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "model": "MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "At dusk, an orange cat walks slowly across a rain-soaked rooftop as the city lights come on, slow tracking shot, cinematic lighting"
      }
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }' | tee h3-create.json

export TASK_ID=$(jq -r '.task_id' h3-create.json)

{
  "task_id": "1792835118519344847"
}

curl -s -X POST "$BASE_URL/hailuo/v2/video_generation" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "model": "MiniMax-H3",
    "content": [
      { "type": "text", "text": "강아지가 해변을 계속 달리고 카메라가 따라갑니다" },
      { "type": "image_url", "role": "first_frame", "image_url": { "url": "https://example.com/start.jpg" } },
      { "type": "image_url", "role": "last_frame", "image_url": { "url": "https://example.com/end.jpg" } }
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "adaptive"
  }'

curl -s -X POST "$BASE_URL/hailuo/v2/video_generation" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "model": "MiniMax-H3",
    "content": [
      { "type": "text", "text": "<Picture 1>의 캐릭터가 공원 산책로를 걷습니다. 카메라 움직임은 <Video 1>처럼, 속도감은 <Audio 1>을 따릅니다" },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/character.png" } },
      { "type": "video_url", "role": "reference_video", "video_url": { "url": "https://example.com/camera-move.mp4" } },
      { "type": "audio_url", "role": "reference_audio", "audio_url": { "url": "https://example.com/beat.mp3" } }
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'

curl -s "$BASE_URL/hailuo/v2/query/video_generation/$TASK_ID" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -o h3-task.json
jq -r '.task.status' h3-task.json

{
  "task": {
    "id": "1792835118519344847",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "created_at": 1792835121,
    "updated_at": 1792835146,
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9",
    "task_type": "generation",
    "modality": "video",
    "usage": {
      "total_seconds": 5,
      "input_seconds": 0,
      "output_seconds": 5,
      "input_image_count": 0
    },
    "content": {
      "url": "https://media.laozhang.ai/videos/1792835118519344847-xxxxxxxxxxxxxxxx.mp4"
    }
  }
}

VIDEO_URL=$(jq -r '.task.content.url // empty' h3-task.json)
curl -L -o h3-output.mp4 "$VIDEO_URL"

import json
import os
import time
import urllib.request
from urllib.error import HTTPError

BASE_URL = "https://api.laozhang.ai"
API_KEY = os.environ["LAOZHANG_API_KEY"]
POLL_INTERVAL = 10  # 초
TIMEOUT = 30 * 60  # 전체 타임아웃 30분


def request(method, path, body=None):
    headers = {"Authorization": f"Bearer {API_KEY}"}
    data = None
    if body is not None:
        headers["Content-Type"] = "application/json"
        data = json.dumps(body).encode("utf-8")
    req = urllib.request.Request(BASE_URL + path, data=data, method=method, headers=headers)
    try:
        with urllib.request.urlopen(req, timeout=60) as resp:
            return json.loads(resp.read().decode("utf-8"))
    except HTTPError as exc:
        error_body = exc.read().decode("utf-8", errors="replace")
        raise RuntimeError(f"HTTP {exc.code}: {error_body}") from exc


created = request(
    "POST",
    "/hailuo/v2/video_generation",
    {
        "model": "MiniMax-H3",
        "content": [{"type": "text", "text": "At dusk, an orange cat walks slowly across a rain-soaked rooftop as the city lights come on"}],
        "resolution": "768P",
        "duration": 5,
        "ratio": "16:9",
    },
)
task_id = created["task_id"]
print("task_id:", task_id)

deadline = time.monotonic() + TIMEOUT
while True:
    task = request("GET", f"/hailuo/v2/query/video_generation/{task_id}")["task"]
    status = task["status"]
    print("status:", status)

    if status == "succeeded":
        # 다운로드 링크에는 Authorization 헤더가 필요 없습니다. 일부 CDN은 Python 기본 User-Agent를 거부하므로 User-Agent를 지정합니다.
        download = urllib.request.Request(task["content"]["url"], headers={"User-Agent": "h3-client/1.0"})
        with urllib.request.urlopen(download, timeout=300) as resp, open("h3-output.mp4", "wb") as f:
            f.write(resp.read())
        print("h3-output.mp4 저장 완료")
        break
    if status == "failed":
        raise RuntimeError(f"작업이 실패했습니다(청구 금액은 환불됨): {json.dumps(task.get('error'))}")
    if time.monotonic() >= deadline:
        raise TimeoutError(f"작업 {task_id}이(가) 30분이 지나도 진행 중입니다. 같은 task_id로 계속 조회하세요")
    time.sleep(POLL_INTERVAL)

POST https://api.laozhang.ai/hailuo/v2/video_generation
GET  https://api.laozhang.ai/hailuo/v2/query/video_generation/{task_id}