Skip to main content
minimax/minimax-h3 の API リファレンスです。MiniMax H3(Hailuo 03)はオムニモーダルな動画モデルで、1 回の生成で映像と音声トラックを同時に出力するため、完成したクリップにはセリフ、効果音、音楽がそのまま含まれます。

クイックスタート

Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python、TypeScript、Swift のスニペットは Comfy SDK (pip install comfy-sdk、npm install @comfyorg/sdk、および ComfySwiftSDK Swift パッケージ) を使用しています。cURL のスニペットは、同じ呼び出しを生の HTTP で行うものです。 モデル ID: minimax/minimax-h3 エンドポイント: POST https://api.comfy.org/v2/models/minimax/minimax-h3

スキーマ

入力

boolean
出力に AIGC ウォーターマークを追加するかどうか。デフォルトは false。
string
任意。チャレンジ検証後にタスクの状態変化を受け取る URL。
object[]
必須
生成を駆動するコンテンツ項目。空でないテキスト項目を 1 つ含める必要があります。任意で first_frame/last_frame の画像や reference_* メディアを追加できます。
object
オーディオソース。audio_url 項目では必須です。
string
一般に公開された URL、mm_file://{file_id} 参照、またはデータ URI。
object
画像ソース。image_url 項目では必須です。
string
一般に公開された URL、mm_file://{file_id} 参照、またはデータ URI。
string
メディア項目の役割。オプション: first_frame、last_frame、reference_image、reference_video、reference_audio、base_video。キーフレームの役割と reference_* の役割は 1 つのリクエスト内で同時に使用できません。base_video はビデオ再生成リクエストのソースビデオを示します。
string
プロンプトテキスト。リクエストごとに空でないテキスト項目がちょうど 1 つ必要です。
string
必須
コンテンツ項目のタイプ。オプション: text、image_url、video_url、audio_url。
object
ビデオソース。video_url 項目では必須です。
string
一般に公開された URL、mm_file://{file_id} 参照、またはデータ URI。
integer
必須
ビデオの長さ(秒)。5 から 15。
string
モデルの ID。オプション: MiniMax-H3。Router の呼び出し元はこのフィールドを省略するか null を送信できます。Router はプロバイダーへのディスパッチ前に、リクエストパスで選択されたモデルを注入します。
string
アスペクト比。オプション: adaptive(デフォルト)、21:9、16:9、4:3、1:1、3:4、9:16。テキストから動画への生成では必須で、adaptive にすることはできません。first-frame または last-frame の生成では無視されます(adaptive として扱われます)。
string
必須
ビデオの解像度。オプション: 2K、768P。
integer
[-1, 2^32 - 1] の範囲のランダムシード。省略するか -1 を指定するとランダムになります。形式: int64
GET /v2/models/minimax/minimax-h3/openapi.json で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しの検証に使用するドキュメントと同じものです。

出力

object
Minimax V2 のビデオ生成タスク。
object
生成済みの出力。status が succeeded の場合に存在します。
string
succeeded になった h3_context_ir タスクによって生成された拡張ビデオプロンプト。
string
生成済み MP4 の期限付き URL。再度クエリすると URL を更新できます。
number
生成済みビデオの再生時間(秒)。
object
status が failed の場合のエラー詳細。code と message を含みます。
string
タスク ID。
string
タスクで使用されたモデル。
string
生成済みビデオの実際の比率。
string
生成済みビデオの解像度。
string
タスクのステータス。オプション: queued、running、succeeded、failed、cancelled、expired。
string
タスクのタイプ。
object
タスクで記録された使用量。
integer
integer
number
number
integer
number
integer

例

入力

出力

MP4 には生成された音声トラックが含まれます。 H3 はオムニモーダルです。音声、サウンドエフェクト、音楽は、後から重ね合わせるのではなく、映像とまとめて単一のフォワードパスで合成され、その結果はネイティブステレオオーディオを持つ 1 つの MP4 になります。上記のリクエストボディでこれを無効にするものはありません。記載されているフィールドはプロンプトのコンテンツ、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 が現在対応していないことと、代替手段。