はじめに
MiniMax H3 HighSpeed の画像からの動画は、手元の静止画から始めて、音付きの 4〜15 秒の 768p MP4 に動かします。見た目は画像で決まるので、プロンプトでは何が動くかだけを書けば足ります。
素材に応じてモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| アイデアだけ | MiniMax H3 HighSpeed テキストからの動画 |
| 動かしたいフレーム（任意で終了フレーム） | MiniMax H3 HighSpeed 画像からの動画 |
| 人物、衣装、場所、動きのクリップ、または声 | MiniMax H3 HighSpeed 参照からの動画 |
主な機能とハイライト
フレームが見た目を決める
顔、服装、光、構図は開始フレームから引き継がれます。クリップはその形を保ち、アスペクト比の項目はないので、送る前に静止画を横長か縦長のお好みの形にトリミングしてください。
任意の終了フレーム
last_image_url を加えると、クリップはその 2 枚目の絵に着地し、2 枚の静止画の間を思いどおりに動かせます。1 つのショットを次のショットへきれいにつなぎたいときに役立ちます。
音声も付く
動きには、波の音、足音、笑い声、引用符で囲んだセリフなど、場面に合った音が追加料金なしで付いてきます。プロンプトに Audio: の行を加えると、音楽の雰囲気や室内音を指定できます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須です。1〜7,000 文字を受け付け、それより長いものは拒否されます。 1 文字以上 · 7000 文字以内 |
image_url | はい | 必須の開始フレームです。クリップはその形に従います。 |
last_image_url | いいえ | 任意の終了フレームで、クリップはここに着地します。価格は加算されません。 |
resolution | いいえ |
|
duration_seconds | いいえ | 4〜15 の整数（既定は 5）で、1 秒ごとに 768p の単価で課金されます。4 秒のリクエストは 3.75 秒のクリップで返りました。 |
料金
料金は完成したクリップの 1 秒ごとに 768p の単価で発生します。最新の単価はモデルページでご確認ください。
| 仕様 | 料金 |
|---|---|
| $0.072 / 秒 |
ユースケース
動く商品写真とファッション写真
ジャケット、バッグ、靴のカタログ写真から、着用する、回す、手に取るといった短いクリップを始められます。光は元の撮影のものがそのまま保たれます。
ポートレートに命を吹き込む
1 枚のポートレートが、微笑み、振り向き、カメラへの一歩といった短いクリップになります。それだけでプロフィール画像やキャラクターカードに命が宿ります。
制御された切り替え
開始フレームと終了フレームを渡すと、モデルがその間の動きを埋めます。ビフォーアフター、衣装替え、ある姿勢で始まり別の姿勢で終わる人物などに使えます。
プロンプトガイドと実践のヒント
画像ではなく、次の瞬間を書く
プロンプトでは、フレームに短い展開を足します。商品がラベルのほうへ回る、ポートレートが顔を上げる、カメラが寄っていく、などです。動き、カメラ、音の順に書いてください。
上限に合うフレームを使う
各辺は 256〜5,760 ピクセル、幅と高さの比率は 0.4〜2.5 に収めてください。出力は 768p であなたのフレームの形に従うので、公開前に顔、ラベル、画面の端を結果で確認しましょう。
合うフレームを組み合わせる
開始フレームと終了フレームは、構図もアスペクト比も揃えてください。4〜15 秒に収まる 1 つの遷移を想定し、最後の 1 秒を見て、ショットが終了フレームに着地しているか確認しましょう。
料金は完成したクリップの 1 秒ごとに 768p の単価で発生します。最新の単価はモデルページでご確認ください。
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-highspeed/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 リファレンスを参照してください。
