はじめに
MiniMax は 2025 年 10 月 28 日、Hailuo 02 の次の一歩として Hailuo 2.3 を、軽量版の Hailuo 2.3 Fast とあわせて公開しました。このエンドポイントは両方を画像から動画として提供します。ショットの始まりとなるフレームをアップロードし、次に起こることを書くと、無音の MP4 が返ります。generation_mode を変えるだけで、リクエストのほかの部分はそのままにフルモデルと Fast 版を選べます。
主な機能とハイライト
物理的に見える動き
MiniMax は 2.3 を、滑らかな身体の動き、カメラの動きへの安定した追従、説得力のある光と影を軸に作り込みました。1080p のテストでは、回転を終えたダンサーの赤いシルクドレスが止まったあとも揺れ続け、裾が固まらずに自然に落ち着きました。
少しずつ変わる表情
このリリースのもう 1 つの目玉が微細な表情の変化です。無表情から始まったクリップが、6 秒のうちに視線、息づかい、笑顔へと移っていけます。雨の窓辺のテストでは、カメラが寄るなかでゆっくり笑顔が広がる様子が見られます。
2 つのモデル、同じリクエスト形式
standard と fast は同じ画像、プロンプト、解像度、長さを受け付けるので、Fast で下書きしたショットを、書き直さずに standard でもう一度レンダリングできます。出力は最初の画像の比率に従い、16:9 の静止画は 1364 × 768、24 フレーム毎秒で返りました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 最初のフレームのあとに起こる動きとカメラワークを 5,000 文字以内で書きます。Hailuo 2.3 は無音なので、セリフは発話されません。 1 文字以上 · 5000 文字以内 |
image_url | はい | 必須の最初のフレームです。JPEG、PNG、WebP、10 MB まで。 |
generation_mode | いいえ | standard(既定)は Hailuo 2.3、fast は Hailuo 2.3 Fast を使います。fast は早く仕上がり、1 本あたりの料金も下がります。 |
resolution | いいえ | 768p(既定)または 1080p。1080p は料金が上がり、長さは 6 秒のみです。 |
duration_seconds | いいえ | 6 秒(既定)または 10 秒。10 秒は 768p が必要で、1 本あたりの料金が上がります。 |
料金
モード(standard か fast)、解像度、長さに応じてクリップ単位で課金します。MiniMax が拒否したリクエストや失敗したリクエストは課金されません。
| 仕様 | 料金 |
|---|---|
| $0.163 / リクエスト |
| $0.256 / リクエスト |
ユースケース
動くキーアート
キャンペーンの静止画、ジャケット写真、ポスター写真から、SNS やティーザー向けの短い動く版を作れます。モデルはまさにその画像から動き始めるので、クリップの最初の 1 秒に合わせて静止画のライティングを整えましょう。
ダンス、ファッション、布の動き
回転や歩き、体のまわりで動く衣服は、このモデルが最も得意とする素材です。すでに動いているフレームから始め、動きがどう終わるかを書くと、クリップに着地点が生まれます。
大量の下書き
1 つのショットのバリエーションがたくさん必要なときは、Fast・768p でまとめてレンダリングして比較し、公開する 1 本だけに standard モードや 1080p を使います。
プロンプトガイドと実践のヒント
アクションを 1 つ、次にカメラ
プロンプトは短いショットの説明として書きます。誰が動き、何をして、どう終わり、カメラが何をするか。たとえば、女性が窓から振り向き、髪を耳にかけ、カメラが寄るなかで微笑む、という具合です。6 秒の中に無関係なアクションをいくつも詰めると、動きが混ざりがちです。
アップロードしたフレームを尊重する
最初の画像が衣装、照明、構図を決めます。新しい服や場所を求めるのではなく、振り向く、一歩踏み出す、風が吹くなど、その画像から自然に育つ変化を書いてください。
長さと解像度はセットで決める
10 秒のクリップは 768p のみ、1080p は 6 秒です。リクエストは露骨にせず思わせぶりな範囲にとどめましょう。MiniMax はプロンプトと完成したクリップを審査し、露骨な言い回しはすぐに拒否され、より露出の多い内容へ流れたシーンは数分後に失敗することがあります。こうしたリクエストはどれも課金されません。
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/hailuo-2.3/image-to-video",
"input": {
"duration_seconds": 6,
"generation_mode": "standard",
"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 リファレンスを参照してください。























