minimax/minimax-h3 の API リファレンスです。MiniMax H3(Hailuo 03)はオムニモーダルな動画モデルで、1 回の生成で映像と音声トラックを同時に出力するため、完成したクリップにはセリフ、効果音、音楽がそのまま含まれます。
入力: テキスト, 画像 · 出力: ビデオ + オーディオ
クイックスタート
Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK (pip install comfy-sdk と npm install @comfyorg/sdk) を使用しています。cURL のスニペットは、同じ呼び出しを生の HTTP で行うものです。
モデル ID: minimax/minimax-h3
エンドポイント: POST https://api.comfy.org/v2/models/minimax/minimax-h3
- 結果を待つ
- キューに送信して後で収集
同じボディを
POST https://api.comfy.org/v2/models/minimax/minimax-h3/requests に送信します。Router は実行が受け付けられ次第 201 と request_id を返し、結果は準備が整った時点で、このプロセスからでも別のプロセスからでも取得できます。ステータス、キャンセル、結果の取得の詳細は キュー配信 を参照してください。スキーマ
入力
生成を駆動するコンテンツ項目。空でないテキスト項目を 1 つ含める必要があります。任意で first_frame/last_frame の画像や reference_* メディアを追加できます。
メディア項目の役割。オプション: first_frame、last_frame、reference_image、reference_video、reference_audio、base_video。キーフレームの役割と reference_* の役割は 1 つのリクエスト内で同時に使用できません。base_video はビデオ再生成リクエストのソースビデオを示します。
ビデオの長さ(秒)。Comfy Router は 4 から 15 を受け付け、それ以外の値はプロバイダーが呼び出される前に拒否します。このモデルに関する MiniMax 自身のドキュメントには 5 から 15 と記載されていますが、ComfyUI MiniMax H3 ノードは 4 から 15 を提供しており、4 秒の生成が成功することも確認されているため、ここでは 4 が受け付けられます。範囲:
4 から 15モデルの ID。オプション: MiniMax-H3。Router の呼び出し元はこのフィールドを省略するか null を送信できます。Router はプロバイダーへのディスパッチ前に、リクエストパスで選択されたモデルを注入します。
アスペクト比。オプション: adaptive(デフォルト)、21:9、16:9、4:3、1:1、3:4、9:16。テキストから動画への生成では必須で、adaptive にすることはできません。first-frame または last-frame の生成では無視されます(adaptive として扱われます)。
ビデオの解像度。オプション: 2K、768P。値は大文字と小文字を区別せずに照合され、ディスパッチ前に正規化されるため、
2k と 768p も受け付けられ、2K と 768P として送信されます。指定可能な値: 2K, 2k, 768P, 768pGET /v2/models/minimax/minimax-h3/openapi.json で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しの検証に使用するドキュメントと同じものです。
出力
例
入力
出力
duration、ratio、resolution、seed、aigc_watermark、callback_url であり、いずれも無音レンダリングを選択するものではありません。したがって、独自のナレーションをクリップに重ねることを意図したパイプラインは、まず返されたトラックをミュートするか取り除く必要があります。そうしなければ、すでに音声が入っているクリップの上に多重化してしまいます。オーディオを方向づけるのはプロンプトです。セリフ、サウンドエフェクト、音楽は、ショットと同じプロンプトブロックに記述してください。プロンプトの構成方法については MiniMax H3 プロンプトガイド を、ComfyUI でこのモデルが何をするかについては MiniMax H3 の概要 を参照してください。
ビデオ URL には有効期限があります。Router は MP4 を再ホストし、12 時間有効な Comfy 署名付き URL を返します。再ホストに失敗した場合は、MiniMax 自身のより短い有効期間のリンクにフォールバックします。上記のレスポンススキーマにある task.content.url の説明は、URL を更新するために再度クエリするよう案内しています。それは MiniMax 自身の API 向けの表現をそのまま引き継いだもので、Router は MiniMax のタスククエリルートを公開していません。キューに登録されたリクエストの結果ルートを再度読み取ると、そのリクエストが完了後 24 時間保持されている間は保存された結果ドキュメントが返されますが、その読み取りによって新たに署名された URL が発行されることを記述した箇所はありません。リンクを保存するのではなく、MP4 を速やかにダウンロードしてください。
出荷前の確認
SDK はIdempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を説明する X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味し、413 はリクエスト本文が Router の受け入れ可能なサイズを超えていたことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
上記のフィールド説明に記載されているサイズ制限は、プロバイダーの仕様から引用した、そのフィールドに対するプロバイダー自身の上限です。Router はリクエスト本文全体に対して別の上限を適用し、base64 エンコードされたメディアもこれにカウントされます。リクエスト本文のサイズ を参照してください。
このページは、Comfy Router 経由で呼び出す 1 つのパートナーモデルについて説明しています。同じ comfy-sdk / @comfyorg/sdk パッケージには、Comfy Cloud 上で ComfyUI のワークフローグラフ全体を実行するための 2 つ目のクライアントも含まれています: Comfy(api_key=...) / new Comfy({ apiKey })、および client.workflows、client.assets、client.jobs。Comfy SDKs を参照してください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。