minimax/minimax-h3 の API リファレンスです。MiniMax のモデルを Comfy Router が提供しています。
クイックスタート
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
- Wait for the result
- Queue and collect later
Schema
入力
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 を指定するとランダムになります。形式:
int64GET /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
例
入力
出力
出荷前の確認
SDK はIdempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。