はじめに
MiniMax H3 360 Orbit Image to video は、写真 1 枚を、静止した一瞬の周りを 360 度回るカメラワークに変えます。最後は最初に使ったフレームで終わります。
主な機能とハイライト
- 写真 1 枚から、360 度ぐるりと回る映像ができます。写真は最初と最後のフレームの両方に使われるため、クリップは出発点に戻ってループします。
- 360 Orbit アダプターを強度 1 で、学習済みの指示文そのままで使うため、プロンプトを書く必要はありません。
- アダプターがない場合、同じベースモデルは始まりと終わりが同じ画像であることを静止画と解釈し、ほとんど動きません。
- 出力は写真の形を保ちます。正方形の写真からは正方形のクリップが生成されます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
image_url | はい | オービットする写真。開始と終了の両方のフレームとして使われるため、クリップはループします。 1 文字以上 |
resolution | いいえ | 480p（既定）、540p、768p、1080p。上位の解像度ほど秒あたりの料金が高くなります。 |
duration_seconds | いいえ | 3〜6 秒（既定は 3）。3 秒が 1 回のきれいに止まった回転です。 |
seed | いいえ | 写真や長さを変えて試す間も、実行結果を比較しやすくします。フレーム単位で同一のクリップになることは保証しません。 |
料金
選んだ解像度での出力秒数に応じて課金されます。
| 仕様 | 料金 |
|---|---|
| $0.05 / 秒 |
| $0.075 / 秒 |
| $0.10 / 秒 |
| $0.20 / 秒 |
ユースケース
- 静止した一瞬のポートレート: カメラが回る間、人物、髪、舞う細部が止まったままになります。
- 1 枚の写真から、ファッションやコーディネートを全方向から見せられます。
- 最後が最初とぴったり一致する、SNS 投稿向けの短いループクリップ。
プロンプトガイドと実践のヒント
- 3 秒が最もきれいに静止します。テストでは、被写体、髪、空中の花びらが回転の間ずっと静止していました。
- 6 秒ではオービットがよりゆっくりになり、人物が動き始めることがあります。テストでは踊るカップルが動き始めました。
- 手前が込み合っていると、被写体がレンズの前を横切ることがあります。混み合った果樹園では、幹が一瞬カメラと被写体の間を通りました。
- クリップに持たせたい写真の形を選んでください。
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-360-orbit/image-to-video",
"input": {
"duration_seconds": 3,
"image_url": "https://example.com/reference.png",
"resolution": "480p"
}
}'
# 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 リファレンスを参照してください。
