Introduzione
MiniMax H3 360 Orbit Image to video trasforma una foto in un’orbita di camera a 360 gradi attorno a un istante congelato, che termina sul fotogramma da cui è partita.
Caratteristiche principali
- Una foto in ingresso, un’orbita completa a 360 gradi in uscita: la tua foto viene usata come primo e ultimo fotogramma, quindi la clip torna al punto di partenza.
- L’adattatore 360 Orbit funziona a intensità 1 con l’istruzione esatta con cui è stato addestrato, quindi non c’è nessun prompt da scrivere.
- Senza l’adattatore, lo stesso modello base legge un inizio e una fine con la stessa immagine come un fermo immagine e quasi non si muove.
- L’output mantiene la forma della tua foto: una foto quadrata dà una clip quadrata.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
image_url | Sì | La foto da far orbitare. Viene usata come primo e come ultimo fotogramma, quindi la clip va in loop. almeno 1 caratteri |
resolution | No | 480p (predefinito), 540p, 768p o 1080p. Le risoluzioni più alte costano di più al secondo; la forma segue sempre la tua foto. |
duration_seconds | No | Da 3 a 6 secondi (predefinito 3). Tre secondi danno un giro pulito e congelato; le clip più lunghe orbitano più lentamente e le persone possono iniziare a muoversi. |
seed | No | Mantiene comparabili le esecuzioni mentre provi foto o durate diverse. Non garantisce una clip identica fotogramma per fotogramma. |
Prezzi
Addebitato per secondo di output alla risoluzione scelta.
| Specifiche | Prezzo |
|---|---|
| $0.05 / secondo |
| $0.075 / secondo |
| $0.10 / secondo |
| $0.20 / secondo |
Casi d’uso
- Ritratti di un istante congelato: una persona, i capelli e i dettagli sospesi restano fermi mentre la camera gira.
- Look di moda e outfit mostrati da ogni lato partendo da un solo scatto.
- Brevi clip in loop per i post social che finiscono esattamente dove iniziano.
Consigli avanzati
- 3 secondi danno il congelamento più pulito: nei nostri test il soggetto, i capelli e i petali sospesi sono rimasti fermi per tutto il giro.
- A 6 secondi l’orbita è più lenta e le persone possono iniziare a muoversi, come una coppia che balla nei nostri test.
- I primi piani affollati possono attraversare l’obiettivo: in un frutteto affollato, i tronchi passavano per un momento tra la camera e il soggetto.
- Scegli la forma della foto che vuoi dare alla clip.
Avvio rapido dell’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"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
