Skip to main content
POST
モデル選択: MiniMax-H3-Max は、速度を優先するテキストから動画、先頭・末尾フレーム制御、マルチモーダル参照生成に適しています。480P、768P、1080P に対応。2K や中間フレームには MiniMax-H3 を使用してください。

認証

string
必須
すべてのエンドポイントで Bearer Token 認証が必要です。API キーページでキーを取得してください。

モデルの選択

MiniMax-H3-Max は 2K に対応せず、出力を Regeneration の元タスクとして使用することもできません。

生成モード

リクエストフィールドからモードが自動判定されます。mode は送信しないでください。
先頭・末尾フレームと参照素材は併用できません。参照音声には参照画像または参照動画が少なくとも 1 つ必要です。不正な組み合わせは同期的に HTTP 400 を返し、タスク作成・課金は行われません。

リクエストパラメータ

string
必須
固定値:MiniMax-H3-Max。大文字小文字は区別されず、minimax-h3-max も使用できます。
string
必須
空でない動画説明。すべてのモードで必須です。最大 7000 文字。
integer
デフォルト:"5"
動画の長さ(秒)。5~15 の整数、既定値 5。4 秒には対応しません。
string
デフォルト:"768P"
出力解像度:480P、768P(既定)、1080P。1080P では watermark と別名の aigc_watermark を省略してください。値が false でも送信しないでください。
2K、1440P、2048P は使用できません。不正な値は HTTP 400 になり、自動的なダウングレードは行われません。
string
出力アスペクト比。size と ratio も使用できます。T2V の値:21:9、16:9、4:3、1:1、3:4、9:16。
  • T2V で省略または adaptive:16:9 にフォールバック
  • I2V:入力画像から決まり、このフィールドは無視
  • マルチモーダル参照:省略可能。既定は adaptive。具体的な比率も指定可能
string
動画の先頭フレームに使う公開画像 URL。
string
末尾フレームに使う公開画像 URL。単独でも first_frame_image と組み合わせても使用できます。
object[]
first_frame_image / last_frame_image / image_urls の代わりに使えるロール付き画像配列。先頭・末尾フレームは各 1 枚まで。この配列と image_urls の参照画像は合計 9 枚まで。フレームロールと参照画像ロールは併用できません。
string[]
参照画像の公開 URL 配列。image_with_roles の参照画像と合計 9 枚まで。すべて参照画像として処理し、先頭・末尾フレームには自動判定しません。先頭フレームには first_frame_image または first_frame ロールを使用してください。
string[]
参照動画の公開 URL 配列。1 本の場合は video_url(string)も使用可能。最大 3 本、各 2~15 秒、参照動画の合計時間は 15 秒以内。送信時に課金用の参照動画時間を読み取ります。読み取れない場合は同期的に HTTP 400 を返し、タスク作成・課金は行われません。
string[]
参照音声の公開 URL 配列。1 本の場合は audio_url(string)も使用可能。最大 3 本、各 2~15 秒、参照音声の合計時間は 15 秒以内。参照画像または参照動画が少なくとも 1 つ必要で、音声だけでは使用できません。
boolean
デフォルト:"false"
AIGC ウォーターマークを追加するかどうか。別名:aigc_watermark。ウォーターマークは 480P / 768P のみ対応します。 1080P では watermark と別名の aigc_watermark を省略してください。値が false でも送信しないでください。
string
タスクが成功または失敗で終了したときに通知を受信します。
MiniMax の callback_url ではなく webhook を使用してください。callback_url はゲートウェイ内部用です。

パラメータ制約

次の不正なパラメータや組み合わせは、タスク作成・課金前に HTTP 400 を返します。 参照動画・参照音声は各 2~15 秒。動画と音声の合計時間は別々に計算し、それぞれ 15 秒以内です。超過する素材は有効な入力ではないため、送信前に切り取ってください。
1080P では watermark と別名の aigc_watermark を省略してください。値が false でも送信しないでください。
2K、中間フレーム、4 秒動画には MiniMax-H3 を使用し、パラメータを調整してください。

入力メディアの制限

リクエスト本文全体は 64 MB 以下。画像・動画・音声は公開 URL を使用し、Base64 は使用しないでください。

画像

参照動画

参照音声

参照音声には参照画像または参照動画が必要です。動画と音声の合計時間は別々に計算し、それぞれ 15 秒以内にしてください。 入力メディアが要件を満たさない場合、生成中に失敗することがあります。失敗タスクは自動返金されます。

例

先頭フレーム指定

先頭・末尾フレーム指定

1080P テキストから動画

1080P では watermark と別名の aigc_watermark を省略してください。値が false でも送信しないでください。

マルチモーダル参照生成

参照動画・参照音声は各 2~15 秒。動画と音声の合計時間は別々に計算し、それぞれ 15 秒以内です。超過する素材は有効な入力ではないため、送信前に切り取ってください。

タスクの照会

送信後に task_id が返ります。タスク状態を 5~10 秒ごとに照会し、クライアントのタイムアウトは 15 分を推奨します。
生成された動画 URL は通常約 24 時間で失効します。早めに保存してください。

料金

総額は生成動画、超過入力画像、参照動画の料金を含みます。
先頭・末尾・参照画像を合算します。最初の 2 枚は無料、超過分は画像ごとに課金。参照動画の合計時間は 15 秒以内です。 すべての単価はモデルの料金設定に準拠します。参照画像 2 枚と参照音声を使う 1080P の例では、画像と音声は無料です。 送信時に見積額を事前確保します。失敗タスクは全額自動返金され、最終金額はタスクの cost が基準です。

エラー

生成中の失敗は status = failed と error.message を返し、自動返金されます。

Response

integer
レスポンスコード。成功時は 200
array
初期状態とタスク ID を含む送信結果