Introduzione
Immagine in video su MiniMax H3 HighSpeed parte da un'immagine fissa che hai già e la anima in un MP4 da 4 a 15 secondi a 768p, con audio. L'immagine fissa l'aspetto; il prompt deve solo dire cosa si muove.
Scegli la modalità in base a ciò che hai già
| Cosa hai | Modalità |
|---|---|
| solo un’idea | MiniMax H3 HighSpeed da testo a video |
| un fotogramma da animare, con un eventuale fotogramma finale | MiniMax H3 HighSpeed da immagine a video |
| persone, outfit, luoghi, clip di movimento o voci | MiniMax H3 HighSpeed da riferimenti a video |
Caratteristiche principali
Il fotogramma definisce l’aspetto
Volti, abiti, luce e composizione arrivano dal tuo fotogramma iniziale. La clip ne mantiene la forma e non esiste un campo per le proporzioni, quindi ritaglia l'immagine nel formato che vuoi, orizzontale o verticale, prima di inviarla.
Fotogramma finale facoltativo
Aggiungi last_image_url e la clip si ferma su quella seconda immagine, così controlli il movimento tra due immagini fisse. Aiuta quando un'inquadratura deve legarsi bene alla successiva.
Suono incluso
Il movimento arriva con un audio coerente, come onde, passi, una risata o una battuta tra virgolette, senza costi extra. Una riga Audio: nel prompt orienta lo stile musicale o il suono dell'ambiente.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Obbligatorio. Accetta da 1 a 7.000 caratteri e rifiuta ciò che è più lungo. almeno 1 caratteri · al massimo 7000 caratteri |
image_url | Sì | Fotogramma iniziale obbligatorio, di cui la clip riprende la forma. Ogni lato deve misurare da 256 a 5.760 pixel, con rapporto larghezza/altezza tra 0,4 e 2,5. |
last_image_url | No | Fotogramma finale facoltativo su cui la clip si ferma. Non aggiunge nulla al prezzo. |
resolution | No |
|
duration_seconds | No | Un numero intero da 4 a 15 (predefinito 5); ogni secondo è fatturato alla tariffa 768p. Una richiesta da 4 secondi è tornata come clip da 3,75 secondi. |
Prezzi
Paghi ogni secondo della clip finita a 768p; la tariffa aggiornata è nella pagina del modello.
| Specifiche | Prezzo |
|---|---|
| $0.072 / secondo |
Casi d’uso
Scatti di prodotto e moda in movimento
Una foto di catalogo di una giacca, una borsa o un paio di scarpe può aprire una clip breve in cui l'articolo viene indossato, girato o raccolto, con l'illuminazione dello scatto originale.
Dare vita a un ritratto
Un solo ritratto diventa una clip breve con un sorriso, una rotazione della testa o un passo verso la camera, quanto basta per dare vita a una foto profilo o a una scheda personaggio.
Transizioni controllate
Con un fotogramma iniziale e uno finale, il modello riempie il movimento tra i due: riprese prima e dopo, cambi d'abito o un personaggio che parte in una posa e finisce in un'altra.
Consigli avanzati
Descrivi il momento successivo, non l’immagine
Usa il prompt per aggiungere una breve sequenza al fotogramma: un prodotto che si gira verso l'etichetta, un ritratto che alza lo sguardo, la camera che si avvicina. Metti prima l'azione, poi la camera, poi il suono.
Usa fotogrammi entro i limiti
Mantieni ogni lato tra 256 e 5.760 pixel e il rapporto larghezza/altezza tra 0,4 e 2,5. L'output segue la forma del tuo fotogramma a 768p, quindi controlla volti, etichette e bordi nel risultato prima di pubblicare.
Abbina fotogrammi coerenti
Dai al fotogramma iniziale e a quello finale la stessa inquadratura e le stesse proporzioni e pianifica una sola transizione che stia in 4–15 secondi. Guarda l'ultimo secondo per verificare se l'inquadratura arriva sul fotogramma finale.
Paghi ogni secondo della clip finita a 768p; la tariffa aggiornata è nella pagina del modello.
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-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"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
