はじめに
MiniMax H3 Lite の参照素材から動画を生成する API は、画像・動画・音声をもとに 480p または 768p・4〜15 秒の音声付きクリップを作成します。プロンプトで画像・クリップ・声を名指しし、シリーズを組む前に登場人物が破綻しないか確かめます。軽量な設計で、アイデアの試作や複数パターンの生成に適しています。1 回のリクエストで 1 本の MP4 が届き、映像と音声が一緒に生成されています。
素材に応じてモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| アイデアだけ | MiniMax H3 Lite テキストからの動画 |
| 動かしたいフレーム(任意で終了フレーム) | MiniMax H3 Lite 画像からの動画 |
| 人物、衣装、場所、動きのクリップ、または声 | MiniMax H3 Lite 参照からの動画 |
主な機能とハイライト
参照は最大 15 件
MiniMax H3 Lite は 1 回のリクエストで、画像を最大 9 枚、動画クリップを 3 本(合計 15 秒)、音声クリップを 3 本まで受け付けます。人物、衣装、部屋、動き、声は、ファイルごとに別々の役を担わせられます。
プロンプトで名前を付ける
「Image 1 の女性」「Video 1 の動き」「Audio 1 の声」といった形で名指しします。番号は、各リストに並べた順番どおりです。
入力に応じた料金
画像 5 枚までは料金に含まれ、超えた分は 1 枚ごとにわずかな料金が加わります。参照動画の秒数は出力の秒数と同様に計算され、音声は無料です。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須、1〜7,000 文字。それより長いプロンプトは拒否されます。 1 文字以上 · 7000 文字以内 |
reference_image_urls | いいえ | 最大 9 枚。番号はプロンプトで使う順に画像へ振ってください(Image 1、Image 2…)。 1 件以上 · 9 件以内 |
reference_video_urls | いいえ | 最大 3 本。各 2〜15 秒、合計 15 秒まで。 1 件以上 · 3 件以内 |
reference_audio_urls | いいえ | 声や音を決める WAV か MP3 を 3 本まで、無料で使えます。無料です。 1 件以上 · 3 件以内 |
aspect_ratio | いいえ | 16:9(既定)、9:16、1:1、4:3、3:4、21:9 から選びます。価格は変わりません。 |
resolution | いいえ |
|
duration_seconds | いいえ | 整数秒、4〜15、既定は 5。この秒数と解像度の組み合わせで、1 秒あたりの料金が決まります。 |
料金
請求は出力 1 秒ごとで、料金は選んだ解像度で決まります。参照動画の秒数は出力秒数と同様に数えます。参照画像は 5 枚まで含まれ、それを超える 1 枚ごとにわずかな料金が加わります。音声は無料です。現在の料金は、いつでもモデルページに表示されています。
| 仕様 | 料金 |
|---|---|
| $0.025 / 秒 |
| $0.04 / 秒 |
ユースケース
別々のファイルから組み立てるシーン
ポートレート、衣装の写真、部屋の写真を 3 枚の画像として送ると、MiniMax H3 Lite はその人物をその衣装でその場所に置きます。登場人物が話すなら、声のクリップを Audio 1 として加えます。
複数のクリップで同じキャラクター
毎回のリクエストで同じポートレートを Image 1 として送ると、MiniMax H3 Lite はシーンが変わっても顔と衣装を保ちます。同じ人物やバーチャルプレゼンターを、シリーズを通して見分けられる状態に保つ使い方ができます。
動きをコピーする
短いクリップを Video 1 として渡し、Image 1 の人物に同じ動きをさせるよう頼めます。ダンスや身振り、カメラワークの再現に向いています。参照クリップは短くすっきりさせると動きが読み取りやすく、秒数分の料金も抑えられます。秒数分が課金されるためです。
プロンプトガイドと実践のヒント
参照ごとに役割は 1 つ
各ファイルに、はっきりした役を 1 つずつ割り当ててください。顔、衣装、部屋、動き、声のどれにするかを決め、その役をプロンプトに明記します。1 枚に複数の役割が混ざると結果が不安定になるので、集合写真よりも顔だけを切り出した画像のほうが安定します。
音声には画像が必要
音声クリップだけでは参照になりません。画像か動画を少なくとも 1 つ送り、話す言葉は引用符で囲んでプロンプトに書きます。音声は声の響きを、プロンプトは発言の内容と話し手を決めます。
先に参照動画を切り詰める
クリップは各 2〜15 秒、合計 15 秒に収められ、その秒数は出力と同じように課金されます。送る前に、見せたい動きが含まれる部分だけに切り詰めてください。
請求は出力 1 秒ごとで、料金は選んだ解像度で決まります。参照動画の秒数は出力秒数と同様に数えます。参照画像は 5 枚まで含まれ、それを超える 1 枚ごとにわずかな料金が加わります。音声は無料です。現在の料金は、いつでもモデルページに表示されています。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3-lite/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p",
"reference_image_urls": [
"https://example.com/reference.png"
]
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。
















