Introduzione
L’API da testo a video di MiniMax H3 Lite genera clip con audio da 4 a 15 secondi a 480p o 768p. Scrivi la scena una volta e rilanciala cambiando un solo dettaglio per volta per vedere quale versione funziona. La versione leggera è adatta a sperimentare idee e produrre più varianti. Ogni richiesta produce un solo MP4 in cui immagine e audio nascono insieme.
Quale modalità aprire in base al punto di partenza
| Cosa hai | Modalità |
|---|---|
| solo un’idea | MiniMax H3 Lite da testo a video |
| un fotogramma da animare, con un eventuale fotogramma finale | MiniMax H3 Lite da immagine a video |
| persone, outfit, luoghi, clip di movimento o voci | MiniMax H3 Lite da riferimenti a video |
Caratteristiche principali
Suono e dialoghi in un solo passaggio
Ogni clip di MiniMax H3 Lite arriva con il suono. Metti le battute tra virgolette doppie e descrivi musica o atmosfera a parole; arrivano entrambe con la clip, quindi una bozza veloce non richiede un passaggio audio a parte.
Sei proporzioni
Le sei proporzioni costano lo stesso, quindi un’idea può essere provata in versione orizzontale e verticale senza differenze di prezzo.
Due fasce di prezzo
480p costa circa il 40% in meno al secondo rispetto a 768p, quindi è il modo economico per esplorare un prompt prima di generare la versione definitiva.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Obbligatorio, da 1 a 7.000 caratteri, dialoghi inclusi; oltre tale limite la richiesta viene rifiutata. Metti le battute parlate tra virgolette doppie. almeno 1 caratteri · al massimo 7000 caratteri |
aspect_ratio | No | Uno tra 16:9 (predefinito), 9:16, 1:1, 4:3, 3:4 o 21:9. Non cambia il prezzo. |
resolution | No |
|
duration_seconds | No | Numero intero di secondi, tra 4 e 15, con 5 come valore predefinito. Fatturato per secondo insieme alla risoluzione. |
Prezzi
Ogni secondo di output viene addebitato alla tariffa della risoluzione scelta, 480p o 768p. La tariffa attuale è sempre mostrata nella pagina del modello.
| Specifiche | Prezzo |
|---|---|
| $0.025 / secondo |
| $0.04 / secondo |
Casi d’uso
Storyboard e clip per le presentazioni
Trasforma una lista di inquadrature in anteprime in movimento sommarie prima di impegnarti in una produzione. Ogni prompt su MiniMax H3 Lite restituisce una clip finita con suono, quindi il pubblico sente la scena oltre a vederla, e un’idea debole può essere scartata prima di produrre qualcosa di costoso.
Bozze di prompt in volume
Autori e sviluppatori di app possono provare molte versioni di una scena su MiniMax H3 Lite e tenere quella che funziona, pagando solo i secondi di output. Se cambi una sola cosa per esecuzione, che sia la camera, l’outfit o una battuta, la serie mostra quale versione merita un rendering più nitido.
Clip verticali con una battuta
Una scena 9:16 di 5–8 secondi con una battuta tra virgolette e un sottofondo si adatta direttamente ai formati social con MiniMax H3 Lite, senza un passaggio di montaggio per il suono. Se pubblichi spesso, tieni fissa l’ambientazione e varia solo azione e battuta; così ogni bozza di 4 secondi a 480p costa $0.10.
Consigli avanzati
Scrivi la scena in ordine
Descrivi chi c’è, cosa fanno prima e poi, dove si trova la camera, e chiudi con una riga Audio: per il suono. Un ordine chiaro si legge meglio di un mucchio di aggettivi, e nominare la luce, ora d’oro o neon per esempio, fissa subito l’atmosfera.
Tieni brevi i dialoghi
Una o due battute tra virgolette si adattano a una clip di 5–8 secondi; indica chi pronuncia ogni battuta, così la persona giusta muove le labbra. I discorsi lunghi escono frettolosi o tagliati, quindi distribuiscili su più clip.
Bozza economica, finale nitido
Itera a 480p e genera la versione definitiva a 768p con lo stesso prompt; la composizione si conserva quasi identica.
Ogni secondo di output viene addebitato alla tariffa della risoluzione scelta, 480p o 768p. La tariffa attuale è sempre mostrata 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-lite/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# 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.
