MiniMax H3 Max Turbo

MiniMax H3 Max Turbo は、テキストやフレーム画像から短い動画を生成します。モデル ID minimax-h3-max-turbo を使用し、返されたタスク ID を保持して完成動画をポーリングします。このページでは SeedRouter が提供するネイティブの content 配列インターフェースを説明します。

モデル 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-turbo",
    "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 の項目

空でないテキスト項目がちょうど 1 つ必要です。role のない画像 1 枚は最初のフレームとして扱います。最初と最後のフレームはそれぞれ最大 1 枚で、最後のフレームには最初のフレームが必要です。参照画像・動画・音声は非対応です。

モード

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

{
  "model": "minimax-h3-max-turbo",
  "content": [
    {"type":"text","text":"Slowly move closer to the ceramic bowl. Keep the glaze and window lighting consistent."},
    {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
    {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
  ],
  "resolution": "480P",
  "duration": 5,
  "ratio": "adaptive",
  "extra": {"prompt_expansion_mode":"balanced"}
}

フレーム画像

認証情報を埋め込んでいない公開 HTTP(S) URL を使います。Base64 と mm_file:// ID は受け付けません。画像は JPG、JPEG、PNG、WebP、HEIC、HEIF に対応し、各 30 MB 以下、各辺 256〜5760 ピクセル、幅/高さは 0.4〜2.5 です。入力は生成前に確認されます。2 枚使う場合は構図とアスペクト比を合わせてください。

コンテンツフィルター

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

課金の内訳

モデルの料金欄に最新レートを掲載しています。Turbo の課金は 1 種類で、選択した解像度の出力秒数です。最初と最後のフレーム、プロンプト拡張に別料金はありません。

cost = reported output seconds × output-second rate for the resolution

見積もりはリクエストした整数秒を使います。最終課金には、完了タスクの出力秒数の使用量と、受理時に記録したレートを使います。有効な使用量が得られない場合は受理時の見積もりを使います。メディアコンテナの時間は課金秒数とわずかに異なる場合があります。料金はアカウントの使用履歴で確認できます。公開タスクのレスポンスに料金は含みません。失敗したタスクには課金されません。

出力スキーマ

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

{"id": "task_...", "model": "minimax-h3-max-turbo", "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-turbo",
  "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-turbo",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

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

ヒント

• 1 ショットにつき、被写体、動作、カメラ移動、照明を 1 つずつ指定します。
• 下書きには 480P、細部を見たいときは 768P を使います。生成し直すたびに別の有料リクエストになります。
• 最初のフレームで冒頭の構図を指定します。最後のフレームを追加するときは最初のフレームも渡してください。
• extra.prompt_expansion_mode で disabled、balanced、quality を選びます。省略すると balanced を維持します。
• 公開前に動画全体と音声を確認してください。プロンプトで商品の形や文字の正確さが保証されるわけではありません。

関連リンク

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

この契約の範囲

このインターフェースは MiniMax の content 配列リクエスト形式を使い、SeedRouter のモデル ID、非同期タスク、URL のみの画像入力、ホストされた結果の配信を組み合わせています。コールバックとキャンセルは利用できません。content_filter は MiniMax のパラメータではなく SeedRouter の入力チェックです。

別の fal ホスト版インターフェースではフィールドと制限が異なります。その 1080P、小数秒の時間、指定音声、順序付き参照の設定はここでは適用されません。このインターフェースは seed と透かしの設定を受け付けません。違いと出典は比較ガイドをご覧ください。