はじめに
MiniMax H3 Lite の画像から動画を生成する API は、1 枚の静止画を 480p または 768p・4〜15 秒の音声付きクリップに変えます。開始フレームを送り、必要なら終了フレームも添えて、まず 480p で動きを確かめてから精細な書き出しに進めます。軽量な設計で、アイデアの試作や複数パターンの生成に適しています。1 回のリクエストで 1 本の MP4 が届き、映像と音声が一緒に生成されています。
素材に応じてモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| アイデアだけ | MiniMax H3 Lite テキストからの動画 |
| 動かしたいフレーム（任意で終了フレーム） | MiniMax H3 Lite 画像からの動画 |
| 人物、衣装、場所、動きのクリップ、または声 | MiniMax H3 Lite 参照からの動画 |
主な機能とハイライト
フレームが見た目を決める
開始フレームが顔、衣装、照明、構図を決めるので、MiniMax H3 Lite はプロンプトを動きに使えます。クリップはフレームの形を保ちます。クリップは送ったフレームの形になり、アスペクト比の欄はないため、アップロード前に横長か縦長に切り抜いてください。
任意の終了フレーム
2 枚目の画像を last_image_url に指定すると、クリップはその画像で終わります。これで 2 枚の静止画が、計画されたつなぎになります。モデルは結末を勝手に作らず 2 枚の間の動きを組み立てるので、あるショットを次のカットにつなぐ場面で役立ちます。
音声も付く
動きには対応する音が付きます。波の音、足音、笑い声、引用したセリフなどが映像と同時に作られ、追加料金はかかりません。シーンから想像される音ではなく、特定の曲調や部屋の響きにしたいときは、Audio: の行を足してください。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須、1〜7,000 文字。それより長いプロンプトは拒否されます。 1 文字以上 · 7000 文字以内 |
image_url | はい | 必須の開始フレーム。クリップはその形を保ちます。 |
last_image_url | いいえ | 任意の終了フレーム。クリップはこのフレームで落ち着きます。 |
resolution | いいえ |
|
duration_seconds | いいえ | 整数秒、4〜15、既定は 5。この秒数と解像度の組み合わせで、1 秒あたりの料金が決まります。 |
料金
請求は出力 1 秒ごとで、料金は選んだ解像度で決まります。現在の料金は、いつでもモデルページに表示されています。
| 仕様 | 料金 |
|---|---|
| $0.025 / 秒 |
| $0.04 / 秒 |
ユースケース
動く商品写真とファッション写真
ジャケット、バッグ、靴のカタログ写真を、MiniMax H3 Lite で短いクリップの出発点にできます。撮影時の照明がそのまま残り、歩く、振り向く、商品を手に取るといった動きが付きます。単純な動きなら撮り直しは要りません。
ポートレートに命を吹き込む
1 枚のポートレートが、MiniMax H3 Lite で自然な動きと音のある短いクリップになります。外見を一から説明する必要はありません。微笑む、振り向く、カメラへ歩み寄る、といった 1 つの動きだけでも、プロフィール写真やキャラクターカードに命が宿ります。
制御された切り替え
開始フレームと終了フレームを用意すると、MiniMax H3 Lite は 2 枚の静止画の間の動きを埋めます。ビフォーアフター、衣装替え、登場人物が別のポーズで終わる物語の節目などに向いています。
プロンプトガイドと実践のヒント
画像ではなく、次の瞬間を書く
フレームを見れば、誰がどこにいるかはすでに分かります。プロンプトには、そのあとの動き、カメラの動かし方、音を順に書いてください。起きる順番に書きます。画像の説明を繰り返すと動きが止まりやすく、「彼女は窓のほうを向く」のように最初の動きを示すと画面が動き出します。
上限に合うフレームを使う
サイズの条件は、一辺 256〜5,760 ピクセル、幅と高さの比率 0.4〜2.5 である必要があります。極端なパノラマ画像は、送る前にトリミングしましょう。被写体がくっきり見える明るい画像のほうが、小さな画像や圧縮のきつい画像より顔が安定します。
合うフレームを組み合わせる
終了フレームは、開始フレームと同じ人物と部屋を写し、新しいポーズ、一歩近づく、表情の変化など、プロンプトで説明できる変化があるときに最も効果的です。関係のない 2 枚の画像だと、カットのような飛びが起きます。
請求は出力 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/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p"
}
}'
# 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 リファレンスを参照してください。
