Skip to main content
POST

認証

string
必須
すべてのAPIエンドポイントはBearer Token認証が必要ですAPIキーの取得:APIキー管理ページにアクセスしてAPIキーを取得してくださいリクエストヘッダーに追加:

生成モード

MiniMax-H3 はリクエストフィールドから対応モードへ自動ルーティングします。mode フィールドは不要です
厳密な相互排他:画像から動画フィールド(first_frame_image / last_frame_image、および image_with_roles 内の first_frame / last_frame)とマルチモーダル参照フィールド(image_urlsvideo_urlsaudio_urls、および image_with_roles 内の reference_image)は同時に指定できません。混在すると 400 が返されます。
音声のみは不可。 audio_urls を渡す場合は、参照画像または参照動画を少なくとも 1 つ併用する必要があります。

リクエストパラメータ

共通フィールド

string
必須
固定値:MiniMax-H3
model フィールドは必須で、明示的に渡す必要があります。 すでに海螺(Hailuo)シリーズを統合済みのクライアントは、modelMiniMax-H3 に変更するだけで本モデルを利用できます。
string
必須
動画コンテンツの説明。あらゆるシナリオで必須かつ空にできません。1 リクエストあたり最大 7000 文字。シーン、主体、動作、スタイルなどを詳しく記述すると、より良い生成結果が得られます。例:"A boy playing basketball by the sea at dusk, waves crashing, cinematic camera work"
integer
デフォルト:"5"
出力の長さ(秒)
  • 範囲:415 の整数
  • デフォルト:5
string
デフォルト:"2K"
動画の解像度
  • 対応値:2K のみ(デフォルト)
string
アスペクト比。size または ratio でも同じ効果で渡せます。利用可能な比率:21:916:94:31:13:49:16シナリオ別の挙動は下記「アスペクト比ルール」を参照してください。
boolean
デフォルト:"false"
AIGC 透かしを付与するかどうかデフォルト:false互換エイリアス:aigc_watermark
string
タスクが終端状態(成功 / 失敗)に達したとき、本サービスがこの URL へプッシュ通知します
webhook を使用してください。公式の callback_url は渡さないでください。callback_url は本サービス内部用であり、ユーザーからの指定は受け付けません。

画像から動画フィールド

先頭 / 末尾フレームの画像から動画を行う場合は、役割を明示的に指定してください。image_urls の枚数から推測しないでください。
string
先頭フレーム画像の URL指定すると、その画像が動画の開始フレームとして使用されます。
string
末尾フレーム画像の URL指定すると、その画像が動画の終了フレームとして使用されます。first_frame_image と組み合わせて先頭+末尾フレーム制御が可能です。

マルチモーダル参照フィールド

string[]
参照画像 URL の配列
image_urls 内の画像は枚数に関係なく、すべて参照画像(reference_image)として扱われます。枚数によって先頭 / 先頭+末尾フレームに自動マッピングされることはありません。
  • 数量:≤ 9
string[]
参照動画 URL の配列
  • 数量:≤ 3
  • 形式と制限:下記「入力メディア制限」を参照
string[]
参照音声 URL の配列
  • 数量:≤ 3
  • 単独では使用不可。参照画像または参照動画と併用する必要があります

共通画像配列(任意の書き方)

object[]
役割付き画像配列。first_frame_image / last_frame_image / image_urls の代替として使用できます。各要素の構造:例(先頭 + 末尾フレーム):
例(参照画像):

アスペクト比ルール

利用可能な具体的比率:21:916:94:31:13:49:16

入力メディア制限

リクエストボディの合計サイズ ≤ 64 MB。大きなファイルは公開 URL を使用し、Base64 は使用しないでください

画像

動画(マルチモーダル参照のみ)

音声(マルチモーダル参照のみ)

パラメータ制約

以下の制約に違反するとリクエストは拒否され 400 が返されます(センシティブコンテンツは 422 の場合あり)。課金は発生しません

レスポンス

integer
レスポンスステータスコード。成功時は 200
array
レスポンスデータ配列

リクエスト例

ケース 1:テキストから動画

ケース 2:画像から動画 — 先頭フレーム

ケース 3:画像から動画 — 先頭 + 末尾フレーム

ケース 4:マルチモーダル参照から動画

ケース 5:image_with_roles で先頭 + 末尾フレームを指定

タスク結果の照会動画生成は非同期タスクで、提出後に task_id が返されます。タスク状態取得 エンドポイントを使用して生成の進捗と結果を照会してください。推奨ポーリング間隔:5 〜 10 秒ごと。クライアントタイムアウト:15 分。成功時、result.videos[0].url が mp4 URL です。動画 URL の有効期限は約 24 時間 — 速やかに保存してください。失敗したタスクは自動的に返金されます。