Introduzione
MiniMax H3 Max Testo in video trasforma un prompt scritto in una clip da 5 a 15 secondi interi a 480p o 768p, con ambiente, foley e musica generati nello stesso passaggio. MiniMax descrive H3 Max come la variante di H3 per la generazione rapida. Prima della prima esecuzione contano due valori predefiniti: il formato è 1:1 e la durata 8 secondi, quindi impostali entrambi in modo esplicito se hai in mente un formato di consegna.
Scegli il metodo in base al materiale di partenza
| Materiale di partenza | Metodo |
|---|---|
| un’immagine iniziale approvata | MiniMax H3 Max Immagine in video |
| una scena scritta o una sceneggiatura | MiniMax H3 Max Testo in video |
Caratteristiche principali
Sei formati, quadrato per impostazione predefinita
aspect_ratio accetta 21:9, 16:9, 4:3, 1:1, 3:4 e 9:16, con 1:1 come predefinito, quindi un brief panoramico inviato senza questo campo torna quadrato. L’esempio snow-train-window-hands è costruito per il 21:9: un treno che attraversa tutta la larghezza del quadro mentre due mani si incontrano ai due lati del vetro della carrozza, una composizione che non sopravvive a un ritaglio più quadrato.
480p per le bozze, 768p per la ripresa finale
resolution accetta 480p o 768p, con 768p come predefinita. Non esistono opzioni 720p, 1080p o 4K, e lo schema rifiuta questi valori prima che la richiesta entri in coda. 480p costa meno al secondo, quindi è adatta a provare testo, durata e inquadratura; la ripresa da tenere va resa a 768p.
L’espansione del prompt è facoltativa
enable_prompt_expansion è disattivato di default, quindi il prompt viene reso così com’è scritto. Se lo attivi, MiniMax espande prima un brief breve in una descrizione più completa di inquadratura, suono e musica, possono comparire dettagli che non hai scritto e la richiesta si paga alla tariffa di espansione del prompt. Gli esempi pubblicati rispondono con la precisione: il prompt di night-train-beckon nomina velluto verde, ottone lucidato, radica di noce, un’unica lampada da lettura e il gesto esatto che la camera deve seguire.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Scrivilo come un’inquadratura: soggetto, movimento, camera, luce, suono – nell’ordine in cui accadono. almeno 1 caratteri · al massimo 7000 caratteri |
aspect_ratio | No | Il valore predefinito è 1:1. Imposta 21:9 per l’anamorfico, 9:16 per il verticale. |
duration_seconds | No | Secondi interi, da 5 a 15. Se lo ometti ottieni 8, non 5. |
resolution | No | 480p o 768p, predefinita 768p. Sono entrambe rese native; 480p costa meno al secondo. |
enable_prompt_expansion | No | Disattivato di default, quindi il prompt viene usato così come l’hai scritto. Predefinito: |
Prezzi
| Specifiche | Prezzo |
|---|---|
| $0.05 / secondo |
| $0.08 / secondo |
Casi d’uso
Moda e film di campagna
L’esempio silver-corridor è un’inquadratura da campagna costruita con un solo paragrafo: un abito d’argento liquido che cattura un controluce duro, capelli mossi da una macchina del vento e, alla fine, uno sguardo dritto in macchina, in 21:9 per cinque secondi, con un drone di synth profondo nell’audio. Il movimento del tessuto, la luce e lo sguardo finale sono scritti; nulla è stato fornito come immagine.
Look d’epoca chiesti per nome
Il carattere di una pellicola si può chiedere direttamente. L’esempio roller-rink richiede un look anni Settanta con alone marcato, colori sbiaditi, grana spessa e un leggero tremolio del quadro, e fa stare in cinque secondi un’azione in due tempi: un giro lento della pista, poi una scivolata all’indietro verso la camera a braccia aperte.
Studi di materiali e luce
Le scene in cui più superfici reagiscono a una luce in movimento si prestano a un brief scritto. In night-train-beckon le luci del binario tracciano strisce su un volto, sul raso e sulle gambe mentre la camera avanza con una profondità di campo cortissima. Usa un brief così per verificare se un’idea di luce si legge prima di preparare i fotogrammi iniziali per image-to-video.
Consigli avanzati
Scrivi l’inquadratura in ordine cronologico
Elenca soggetto, movimento, camera, luce e suono nell’ordine in cui avvengono. Il prompt di silver-corridor segue l’inquadratura dal primo passo fino allo sguardo finale, poi aggiunge la resa dell’immagine («anamorphic 2.39:1, deep blacks, glossy specular highlights») e chiude con il suono («low synth drone»).
Scrivi i limiti oltre all’azione
Se attivi l’espansione, scrivi ciò che deve restare fisso oltre a ciò che deve accadere. Il prompt di night-train-beckon termina con vincoli chiari: la sottoveste di raso e le calze restano indossate per tutta la durata, e nel quadro non ci sono testo, loghi né altre persone. La prosa lascia al modello costume, corpo e inquadratura; senza questi dettagli scritti, le esecuzioni consecutive divergono.
Passa a image-to-video per un risultato letterale
Quando una ripresa centra l’idea ma il soggetto non è esattamente come progettato, genera o scegli un’immagine e passa a image-to-video: un fotogramma iniziale viene seguito con molta più fedeltà della stessa descrizione in un prompt. Imposta la durata con intenzione, perché se la ometti ottieni 8 secondi, non 5.
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-max/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p",
"aspect_ratio": "1:1",
"duration_seconds": 8,
"enable_prompt_expansion": false
}
}'
# 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.
