> ## Documentation Index > Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt > Use this file to discover all available pages before exploring further. # MiniMax-H3 動画生成 API リファレンス > MiniMax-H3 動画生成APIリファレンスおよびライブPlayground：テキスト、先頭/末尾フレーム、参照画像/動画/音声による動画に対応した単一エンドポイント。非同期送信とtask_idによる照会、768P、4〜15秒、秒単位での課金。 右側のインタラクティブなPlaygroundで、リアルタイムにテストを行えます。**Authorization**にAPI Keyを入力し（形式は`Bearer sk-xxx`）、`content`にテキスト項目を1つ追加して（必要に応じて画像、動画、音声項目も追加）、`duration`と`ratio`を選択して送信してください。レスポンスは`task_id`です。後述のクエリエンドポイントを使用して動画を取得してください。 **1つのエンドポイント、4つのモード**: テキストのみ = テキストから動画生成、`first_frame` / `last_frame` 画像を追加 = キーフレーム動画、`reference_image` / `reference_video` / `reference_audio` を追加 = 参照動画。モードは`content[]`から推測されるため、エンドポイントを切り替える必要はありません。全体像については[MiniMax-H3の概要](/ja/api-capabilities/minimax-h3/overview)をご覧ください。 **⚠️ 最もよくある4つの間違い** 1. **パスは`/hailuo`で始まります**: `POST /hailuo/v2/video_generation`で作成し、`GET /hailuo/v2/query/video_generation/{task_id}`でクエリします。単なる`/v2/...`パスはJSONではなくWebページを返します 2. **`duration`は4から15の整数である必要があります**: 文字列`"5"`や`5.5`のような小数は拒否されます 3. **`resolution`は大文字の`768P`である必要があります**: `768p`と`2K`はどちらも拒否されます 4. **テキストのみおよび音声のみのリクエストでは`ratio: "adaptive"`を使用できません**。固定の比率を選択してください。`adaptive`はリクエストに画像または動画が含まれている場合にのみ機能します ## コード例 ### Python (requests · 送信 + ポーリング + ダウンロード) ```python theme={null} import time import requests API_KEY = "sk-your-api-key" BASE = "https://api.apiyi.com/hailuo/v2" HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"} # Step 1: submit the task payload = { "model": "MiniMax-H3", "content": [ {"type": "text", "text": "A lighthouse by the sea at dusk, slow dolly in, waves crashing on the rocks, cinematic lighting"} ], "resolution": "768P", # uppercase 768P only "duration": 5, # integer 4–15, billed per second "ratio": "16:9", # text-only requests need a fixed ratio } for attempt in range(3): # Submitting takes a few seconds; occasional 500s at peak are not billed, so back off and retry r = requests.post(f"{BASE}/video_generation", headers=HEADERS, json=payload, timeout=60) if r.status_code != 500: break time.sleep(5 * (attempt + 1)) r.raise_for_status() task_id = r.json()["task_id"] print("task_id:", task_id) # Step 2: poll (usually 2–4 minutes; give up after 15) deadline = time.time() + 900 while time.time() < deadline: task = requests.get(f"{BASE}/query/video_generation/{task_id}", headers=HEADERS, timeout=30).json()["task"] print(task["status"]) if task["status"] == "succeeded": video_url = task["content"]["url"] break if task["status"] == "failed": # Failed tasks are refunded automatically; the reason is in error raise RuntimeError(task["error"]) time.sleep(10) else: raise TimeoutError(task_id) # Step 3: download (no auth header needed; use GET, not HEAD, to check the URL) with requests.get(video_url, stream=True, timeout=300) as v, open("output.mp4", "wb") as f: v.raise_for_status() for chunk in v.iter_content(1 << 16): f.write(chunk) print("Saved: output.mp4") ``` ### Python (ファーストフレーム動画 · リクエストボディ) ```python theme={null} payload = { "model": "MiniMax-H3", "content": [ {"type": "text", "text": "The character slowly turns and smiles, a light breeze moves the hair, gentle push-in"}, {"type": "image_url", "image_url": {"url": "https://your-cdn.example.com/first.png"}, "role": "first_frame"}, ], "resolution": "768P", "duration": 5, "ratio": "adaptive", # follow the first frame's aspect ratio } ``` ### Python (混合リファレンス · リクエストボディ) ```python theme={null} payload = { "model": "MiniMax-H3", "content": [ # Numbered by order within each media type: first image = , first video =