Aggiornamento lancio — 31 luglio 2026: MiniMax H3 (Hailuo 03) è ora disponibile su Poyo.ai, con uno sconto del 20% per un periodo limitato. Il video generato e la durata dei video di riferimento costano 21 crediti al secondo; le prime cinque immagini di riferimento sono gratuite, poi ogni immagine aggiuntiva costa 6,4 crediti. Questo aggiornamento sostituisce le indicazioni di disponibilità precedenti al lancio riportate di seguito.
MiniMax H3 sta attirando attenzione come nuovo modello video, ma bisogna distinguere le demo dall’accesso per sviluppatori. Al 30 luglio 2026, la documentazione API pubblica di MiniMax non elenca H3 come modello disponibile.
I riferimenti ufficiali text-to-video e image-to-video riportano MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02 e modelli precedenti. Non sono stati pubblicati ID H3, schema della richiesta, prezzo API o data di disponibilità generale. Anche il codice prodotto pubblico di Poyo.ai non contiene un model/service H3.
Questa guida separa ciò che è verificato dalle incognite e propone un’integrazione prudente da preparare. Per le capacità leggi la recensione completa di MiniMax H3; per la scelta consulta MiniMax H3 vs Seedance 2.5.
Stato dell’API H3
| Domanda | Stato verificato al 30 luglio 2026 |
|---|---|
| H3 è nell’enum pubblico dei modelli? | No |
| Esiste un ID H3 ufficiale? | No |
H3 è confermato su /v1/video_generation? | No |
| Durata, risoluzione, audio e riferimenti sono documentati? | No |
| Il prezzo API H3 è pubblico? | No |
Prima di implementare, ricontrolla la guida video ufficiale, il riferimento T2V, il riferimento I2V e i prezzi pay-as-you-go. Cambiare un esempio esistente in "model": "H3" non crea una richiesta supportata.
Cosa indica l’API attuale
Il workflow documentato è asincrono: invio del job e ricezione di task_id, polling dello stato e recupero del video con file_id dopo il successo. Alcuni modelli documentati offrono text-to-video, image-to-video, primo/ultimo fotogramma e riferimento del soggetto.
È un precedente architetturale utile, ma non conferma endpoint, campi o limiti di H3. Anche i limiti di Hailuo 2.3 — 768P per 6 o 10 secondi e 1080P per 6 secondi — non sono specifiche H3.
Prezzo API H3: non annunciato
Alla pubblicazione non esiste un prezzo H3 verificabile. Non dedurlo da abbonamenti web, promozioni, screenshot social o modelli precedenti.
Solo come contesto, la pagina ufficiale indica per Hailuo 2.3: 0,28 USD per 768P/6 s, 0,56 USD per 768P/10 s e 0,49 USD per 1080P/6 s. Sono prezzi dei modelli nominati e non una stima H3.
Quando il prezzo sarà pubblicato, calcola:
costo per secondo utilizzabile =
(tentativi addebitati × prezzo per tentativo + storage + post-produzione)
÷ secondi approvati
Verifica inoltre addebiti per fallimenti, moderazione, audio, alta risoluzione, riferimenti e code prioritarie.
Pattern sicuro e indipendente dal provider
Il seguente è pseudocodice agnostico, non una richiesta MiniMax H3 ufficiale ed eseguibile. Sostituisci i placeholder solo con valori della documentazione H3 attiva.
// PSEUDOCODE — NOT AN OFFICIAL MINIMAX H3 REQUEST
const job = await videoProvider.submit({
model: MODEL_ID_FROM_LIVE_H3_DOCS,
prompt,
references,
output: optionsFromLiveDocs,
idempotencyKey: `h3:${internalJobId}`,
callbackUrl: SECURE_SERVER_WEBHOOK,
});
await jobs.save(internalJobId, job.taskId, maxAllowedCost);
Limita il polling e usa backoff esponenziale con jitter. Salva successo, errore e annullamento come stati terminali. Un timeout ambiguo va riconciliato, non reinviato alla cieca. Conserva le chiavi lato server, verifica le firme webhook, rendi i callback idempotenti e controlla tipo e dimensione prima di copiare un output temporaneo.
Struttura dei prompt
In assenza di una guida pubblica ai prompt H3 API, usa questo schema neutro:
Soggetto: persona o oggetto di cui preservare l’identità
Ambiente: luogo, ora, meteo e sfondo
Azione: una sequenza visibile con causalità chiara
Camera: inquadratura, resa della lente, movimento e continuità
Look: luce, palette, texture e genere
Suono: dialogo, ambiente, effetti e intento musicale
Timeline: beat ordinati con tempi realistici
Vincoli: identità, forma del prodotto, logo ed elementi da preservare
Inizia con un soggetto, un’azione e un movimento di camera. Aggiungi separatamente dialogo, più personaggi, transizioni o fisica complessa.
Spot di prodotto
Un flacone di profumo trasparente su pietra nera dopo la pioggia. Conservare
forma, tappo, etichetta e posizione del logo del riferimento. Piano sequenza
di 8 secondi: macro sulle gocce, lento avvicinamento e orbita dolce che rivela
una luce ambrata. Rifrazione realistica, nessun testo aggiunto o deformazione.
Intento sonoro: pioggia leggera e un basso discreto nel reveal finale.
Dialogo del personaggio
Mezzo primo piano della chef di riferimento in una cucina aperta all’alba.
Guarda in camera e dice: «I buoni ingredienti non hanno bisogno di nascondersi».
Respiro naturale e gesti contenuti. Carrello lento da sinistra al centro;
preservare volto, capelli, logo del grembiule e layout. Luce calda, realismo documentario.
Pubblicità gaming verticale
Trailer fantasy 9:16. Preservare eroe, lancia blu e spallaccio argento dei
riferimenti. 0–3 s: entra da un portale in rovina. 3–6 s: una creatura carica
e l’eroe para una volta. 6–9 s: la camera sale e rivela la città. Geometria
dell’arma stabile, niente UI o sottotitoli inventati. Ultimo secondo libero per la UI.
Organizzare riferimenti multipli
L’API pubblica H3 non conferma numero o tipi di riferimento. Non progettare un modulo di produzione su limiti circolati sui social. Crea un reference manifest neutro con ruoli per personaggio, prodotto, ambiente, stile, storyboard e audio solo se documentato. Per ogni asset salva ID stabile, ruolo, caratteristiche da preservare e variazioni consentite. Definisci priorità nei conflitti, rifiuta URL non accessibili e invia il minimo necessario.
Checklist di produzione
- Tenere H3 dietro feature flag finché ID e schema non sono documentati.
- Validare MIME, dimensioni, durata, lunghezza prompt e riferimenti sulle docs live.
- Rendere idempotenti invio e webhook.
- Ritentare solo errori transitori, non input invalidi o moderati.
- Limitare tentativi, concorrenza e budget per utente e progetto.
- Registrare versione, prompt, hash, seed se supportato e revisione.
- Far verificare identità, testo, loghi, fisica, audio e claim commerciali.
- Riconciliare ogni giorno job inviati, addebitati, falliti e mancanti.
Domande frequenti
L’API MiniMax H3 è disponibile?
Non nella documentazione pubblica al 30 luglio 2026. Un eventuale accesso privato non equivale alla disponibilità generale.
Qual è l’ID del modello H3?
Non è pubblicato. Non inventare H3, MiniMax-H3 o Hailuo-H3.
Posso chiamare H3 tramite /v1/video_generation?
L’endpoint è documentato per modelli attuali, ma la compatibilità H3 non è confermata. Attendi H3 nell’enum supportato.
Quanto costa l’API H3?
Il prezzo non è annunciato. I prezzi Hailuo 2.3 non sono prezzi H3.
Supporta audio nativo e riferimenti multipli?
Campi e limiti pubblici mancano. Verifica audio, tipi e numero di riferimenti, limiti file e fatturazione prima del lancio.
Cosa preparare ora?
Adapter asincrono, reference manifest, prompt di test, stato idempotente e limiti di spesa. Attiva traffico reale solo dopo conferma di ID, endpoint, schema, prezzo e termini.