MiniMax H3

MiniMax H3（Hailuo 03）は MiniMax のマルチモーダル動画モデルです。1 回のリクエストで映像と音を一緒に生成します。生成されるのは、セリフ・環境音・効果音付きの 768P または 2K、4〜15 秒のクリップです。リクエストボディは MiniMax の公式形式で、モデル ID は minimax-h3 です。リクエストを送信し、返されたタスク ID を保持して、完成した動画をタスクから読み取ってください。フレームと参照は URL で渡します。

モデル ID

現在の料金はモデルページをご覧ください。

クイックサンプル

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "content": [
      {"type": "text", "text": "A small sailboat glides across a calm turquoise bay at sunrise, seagulls in the distance, the sound of water and wind. No text, no logos."}
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'

エンドポイント

POST https://api.seedrouter.ai/v1/videos/generations

レスポンスはタスク（{"id": "task_...", "status": "processing"}）であり、完成した動画ではありません。結果は GET /v1/tasks/{task_id} をポーリングして取得してください。API キーはサーバー側のコードに保管してください。

パラメータ

スキーマは厳格です。未知のフィールドは無視されず、拒否されます。callback_url は利用できません。代わりにタスクをポーリングしてください。extra は MiniMax-H3-Max 用のもので、このモデルでは受け付けません。

Content の項目

role のない画像が 1 枚だけなら、それが最初のフレームになります。画像が 2 枚以上ある場合は、すべての画像に role が必要です。

モード

モードは content の項目で決まります。モード用のフィールドはありません。

1 つのリクエストでフレームと参照を組み合わせることはできません。

{
  "model": "minimax-h3",
  "content": [
    {"type": "text", "text": "The person in the photo speaks to camera: Follow the wind. Voice follows the reference audio."},
    {"type": "image_url", "image_url": {"url": "https://example.com/person.jpg"}, "role": "reference_image"},
    {"type": "audio_url", "audio_url": {"url": "https://example.com/voice.mp3"}, "role": "reference_audio"}
  ],
  "resolution": "2K",
  "duration": 6
}

メディア入力

画像、動画、音声の項目はすべて公開 HTTP(S) URL です。Base64 のデータ URI と mm_file:// ID は受け付けません。ファイルを自分のストレージにアップロードし、その URL を渡してください。

参照動画はリクエストの受理時に計測されます。長さを読み取れない動画は拒否され、課金されません。その他の制限は生成前にチェックされ、いずれかに違反したリクエストは課金なしで失敗します。

コンテンツフィルター

指定しない限り、content_filter は true です。フィルターがオンのとき、モデルの実行前に、テキスト、すべての画像、各参照動画の 3 フレーム（最初・中間・最後）がチェックされます。フラグが立ったリクエストはコード 60001 で失敗し、課金されません。チェックできなかったリクエストも同様です。参照音声はチェックされません。content_filter を false にするとチェックを省略できます。Web サイトの Playground では常にオンのままです。

課金に影響する要素

現在のレートはモデルの料金セクションで確認してください。MiniMax H3 は動画 1 秒単位で課金され、レートは出力解像度で決まります。加えて、最初の 5 枚を超える入力画像が課金されます:

billed seconds = duration + ceil(Σ each reference video's seconds)
extra images   = max(0, number of images − 5)
cost = billed seconds × rate per second + extra images × rate per image

最初のフレーム、最後のフレーム、参照画像はいずれも画像として数えられます。参照音声は課金されません。どちらの数量もリクエストの受理時に確定するため、確保される金額がそのまま課金額になります。最終的な課金額はアカウントの利用履歴で確認できます。失敗したタスクは課金されません。

出力スキーマ

送信するとタスクが返されます:

{"id": "task_...", "model": "minimax-h3", "status": "processing", "created_at": 1789689600}

タスクを取得する

GET https://api.seedrouter.ai/v1/tasks/{task_id}

status が completed または failed になるまで、10〜20 秒ごとにポーリングしてください。ポーリング中のネットワークタイムアウトは生成の失敗を意味しません。タスク ID を保持して確認を再開してください。進捗確認のために別のタスクを作成しないでください。

完了したタスク

{
  "id": "task_...",
  "model": "minimax-h3",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689740,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4",
    "resolution": "768P",
    "ratio": "16:9",
    "duration": 5
  }
}

ratio はクリップが作られたアスペクト比で、adaptive で選ばれたものも含みます。私たちのテストでは、16:9 の 4 秒・768P クリップが MP4（H.264）、1344 × 768、24 fps で返り、32 kHz のステレオ AAC トラックが付いていました。

エラー

タスク作成前に拒否されたリクエストは、HTTP エラーと error オブジェクトを返し、課金されません。受理後に失敗したタスクは、照会時に HTTP 200 と status: "failed"、そして error オブジェクトを返します。

コード・HTTP ステータス・リトライの指針は共通エラーカタログを参照してください。

{
  "id": "task_...",
  "model": "minimax-h3",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

送信自体がタイムアウトした場合は、再送信の前にタスクを確認してください。最初のリクエストが受理されている可能性があります。

ヒント

• ショットとその音を一緒に記述してください。被写体、場所、カメラ、光、セリフ、効果音です。
• セリフはプロンプトに書き、声を合わせたい場合は参照音声を添付してください。
• 768P で下書きし、最終ショットは同じリクエストを 2K でレンダリングしてください。
• ショットの始まりと終わりは最初と最後のフレームで、商品・人物・動きを保つには参照で制御してください。
• 勝手なマークが入らないよう、no text, no logos を加えてください。

関連情報

• MiniMax H3 の Playground と料金
• OpenAPI をダウンロード
• コピー可能な Markdown