MiniMax H3 Max

MiniMax H3 Max は MiniMax H3 の高速生成版です。1 回のリクエストで映像と音を一緒に作ります。480P または 768P、5〜15 秒のクリップに、セリフ、環境音、効果音が含まれます。リクエストボディは MiniMax の公式形式で、モデル ID は minimax-h3-max です。送信して返されたタスク 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-max",
    "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 は prompt_expansion_mode のみを含む任意の厳密なオブジェクトです。すべてのフィールドで null を拒否します。任意フィールドは代わりに省略してください。

content の項目

role のない画像 1 枚は最初のフレームです。複数の画像を使う場合は、各画像に role が必要です。

モード

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

フレームと参照は 1 つのリクエストで併用できません。公式ドキュメントには最後のフレームのみの入力が記載される一方、最初のフレームも必要という矛盾した条件があります。このケースは SeedRouter では未検証です。終了画像が必要な場合は両方のフレームを使ってください。

{
  "model": "minimax-h3-max",
  "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": "768P",
  "duration": 6
}

メディア入力

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

参照動画はリクエスト受理時に長さを測定します。長さを取得できない動画は拒否し、課金しません。ほかの制限は生成前に確認し、違反するリクエストは失敗して料金はかかりません。

コンテンツフィルター

指定しなければ content_filter は true です。有効な場合、テキストとメディアを含むリクエストを生成前に審査します。拒否されたリクエストはコード 60001 で失敗し、課金されません。content_filter を false にすると審査を省略します。Web の Playground は常に有効です。

課金の内訳

最新レートはモデルの料金欄をご覧ください。MiniMax H3 Max は、出力解像度に応じて生成出力秒数と参照動画秒数を別々に課金します。最初の 2 枚の画像は無料で、それ以降は 1 枚ごとに課金されます。

output seconds = reported generated seconds
input seconds  = reported reference-video seconds
extra images   = max(0, reported input image count − 2)
cost = output seconds × output rate
     + input seconds × reference-video rate
     + extra images × image rate

参照動画の長さを合計して、最も近い整数秒に四捨五入したものを最終使用量とします。したがって 2.4 秒の動画 2 本は、入力 5 秒として数えられます。参照音声に入力料金はありません。最初と最後のフレームも画像として数えるため、その 2 枚だけなら画像料金はかかりません。

Playground の見積もりは、最終料金をカバーするよう参照動画の長さを切り上げます。最終使用量にはリクエスト時に記録したレートを適用します。完全な使用量報告がない場合は受理時の見積もりを使います。料金はアカウントの使用履歴で確認できます。公開タスクのレスポンスに料金は含みません。失敗したタスクには課金されません。

出力スキーマ

送信するとタスクが返ります。

{"id": "task_...", "model": "minimax-h3-max", "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-max",
  "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 で選ばれた比率も含みます。報告された場合、タスクには実際の解像度、比率、時間が含まれます。上記 JSON はレスポンスの形を示す例で、生成の実測結果ではありません。

エラー

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

コード、HTTP ステータス、再試行の指針は共通エラー一覧をご覧ください。

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

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

ヒント

• 被写体、場所、カメラ、照明、セリフ、効果音を含め、映像と音を一緒に説明します。
• セリフをプロンプトに書き、声を参照に合わせたい場合は参照音声を添付します。
• 480P で下書きし、細部が必要なら 768P を選びます。再生成は別の有料リクエストです。
• 完成したプロンプトには extra: {"prompt_expansion_mode": "disabled"} を使うか、balanced / quality の拡張を選びます。
• 最初と最後のフレームでショットの始点と終点を指定します。商品、人物、動きを保つために参照素材を使います。
• no text, no logos を加え、架空の文字やマークが入るのを避けます。

関連リンク

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

契約の出典

パラメータは MiniMax の動画生成ドキュメントに従います。SeedRouter は独自のモデル ID と非同期タスクインターフェース、URL のみのメディア入力、ホストされた結果の配信を使用します。コールバックとキャンセルは利用できません。content_filter は SeedRouter の拡張です。