API MiniMax H3 per la Generazione Video

Accedi a MiniMax H3 tramite l'API aperta indipendente di GoEnhance. Invia testo, fotogrammi o file multimediali di riferimento a un flusso di lavoro REST asincrono; ricevi un img_uuid; quindi effettua il polling per il risultato o registra un callback. H3 genera audio stereo nativo — dialoghi, effetti sonori e rumore d'ambiente — durante lo stesso passaggio del video.
Crea una Chiave API
Regista cinematografico accanto a una cinepresa su un set illuminato professionalmente

Scegli il Modello H3 che Corrisponde ai Tuoi Input

hailuo_h3: Testo, Primo Fotogramma o Primo e Ultimo Fotogramma

Usa hailuo_h3 per text-to-video, image-to-video con image_url o controllo del primo e ultimo fotogramma con image_end_url opzionale. Il prompt è obbligatorio e può contenere fino a 7.000 caratteri. Consulta il playground live e il riferimento completo ai parametri.
Creatore che dirige le riprese di un video di prodotto con attrezzatura fotografica e di illuminazione professionale

hailuo_h3_refs: Generazione Basata su Riferimenti

Usa hailuo_h3_refs quando una singola richiesta necessita di un massimo di 9 immagini di riferimento, 3 video di riferimento e 3 clip audio di riferimento. Questo percorso utilizza il canale ufficiale di MiniMax e offre output a 768P e 2K. Consulta l' endpoint di riferimento per video.
hailuo_h3_refs: Generazione Basata su Riferimenti

Accesso API Unificato Indipendente

L'API aperta di GoEnhance è una piattaforma di terze parti indipendente che fornisce un accesso unificato a modelli video e di immagini. Non è MiniMax o Hailuo e non è affiliata o approvata da MiniMax. MiniMax e Hailuo sono marchi dei rispettivi proprietari e sono utilizzati solo per identificare il modello.
Accesso API Unificato Indipendente
Convalida questi campi prima dell'invio in modo che le richieste non valide vengano rifiutate prima che i token vengano detratti.

Parametri e Limiti dell'API MiniMax H3

Endpoint condiviso e risposta asincrona

Invia uno dei due modelli a POST https://api.goenhance.ai/api/v1/videos/generations. La risposta restituisce un img_uuid; la generazione continua in modo asincrono.

durata e prompt di hailuo_h3

duration deve essere un numero intero compreso tra 5 e 15 secondi, con un valore predefinito di 5. Valori non interi o fuori intervallo vengono rifiutati prima della detrazione dei token. prompt è obbligatorio e accetta fino a 7.000 caratteri.

risoluzione e proporzioni di hailuo_h3

Scegli 480p, 720p o 2K. Solo per text-to-video, ratio accetta 21:9, 16:9, 4:3, 1:1, 3:4 o 9:16. Quando image_url fornisce un primo fotogramma, l'output segue quell'immagine e il parametro ratio non viene utilizzato.

input dei fotogrammi di hailuo_h3

Passa image_url per un primo fotogramma e image_end_url opzionale per un ultimo fotogramma. Questo ID modello copre text-to-video, image-to-video e generazione del primo e ultimo fotogramma.

input di riferimento di hailuo_h3_refs

Una singola richiesta accetta fino a 9 immagini in ref_imgs, 3 video in ref_videos e 3 clip audio in ref_audios. La durata è un numero intero da 5 a 15 secondi, con un valore predefinito di 5; la risoluzione è 768P o 2K.

Audio stereo nativo

H3 genera dialoghi, effetti sonori e rumore d'ambiente come audio stereo nativo nello stesso passaggio dell'immagine, anziché doppiare l'audio in un secondo momento.
Il costo per chiamata è la tariffa al secondo selezionata moltiplicata per la durata di output richiesta. I modelli video fatturano al secondo di output.

Prezzi di MiniMax H3 al secondo

hailuo_h3 — 480p: $0,030 al secondo

Un livello di pipeline di GoEnhance per un'iterazione del prompt a costi inferiori. Non è un livello di output supportato ufficialmente da MiniMax.

hailuo_h3 — 720p: $0,060 al secondo

Un livello di pipeline di GoEnhance per un'iterazione a costi inferiori prima della selezione delle riprese finali. Non è un livello di output supportato ufficialmente da MiniMax.

hailuo_h3 — 2K: 0,090 $ al secondo

Utilizza il livello 2K per le riprese selezionate che necessitano della risoluzione di output ufficiale di MiniMax.

hailuo_h3_refs — 768P: 0,099 $ al secondo

La generazione basata su riferimenti avviene tramite il canale ufficiale di MiniMax e utilizza pertanto livelli e prezzi differenti.

hailuo_h3_refs — 2K: 0,143 $ al secondo

Il livello del canale ufficiale 2K per le richieste basate su riferimenti.

Token, rimborsi e concorrenza

L'utilizzo viene fatturato in token: 10 $ equivalgono a 500 token, ovvero 0,02 $ per token. I punti vengono detratti una sola volta al momento dell'invio e rimborsati interamente se la generazione fallisce. La concorrenza dipende dal livello di build dell'account e parte da 3 attività incompiute simultanee. Consulta i livelli di prezzo e i crediti.

Integra l'API video di MiniMax H3

1

1. Crea e proteggi una chiave API

Crea una chiave su /keys. Inviala come Authorization: Bearer <chiave API>; non esporla nel codice del browser o nei log.
2

2. Seleziona un modello e convalida la richiesta

Scegli hailuo_h3 per il controllo del testo o dei fotogrammi, oppure hailuo_h3_refs per il supporto dei riferimenti. Convalida la durata, la risoluzione, l'applicabilità del rapporto d'aspetto, la lunghezza del prompt e il numero di input prima dell'invio.
3

3. Invia e mantieni img_uuid

Invia la richiesta tramite POST a https://api.goenhance.ai/api/v1/videos/generations. Salva l'img_uuid restituito insieme al tuo record di lavoro, poiché l'attività è asincrona.
4

4. Esegui il polling o ricevi callback

Esegui il polling su GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=... oppure registra un URL di callback. Un callback con status=0 viene attivato all'avvio dell'attività; un callback finale conterrà il risultato.
5

5. Gestisci convalida, errori e concorrenza

Non riprovare richieste con durata non valida o combinazioni di input incompatibili senza modifiche. Le generazioni non riuscite ricevono un rimborso completo. Metti in coda le richieste quando le attività incompiute raggiungono il limite di concorrenza consentito dal tuo livello di build.
Crea una chiave API
Crea pipeline multimediali ripetibili basate su processi asincroni, audio nativo e input espliciti di fotogrammi o riferimenti.

Cosa sviluppano i programmatori con H3

Varianti pubblicitarie programmatiche

Genera batch di concept per campagne brevi partendo da prompt strutturati, quindi conserva solo gli output approvati.

Pipeline per clip di prodotto

Utilizza l'immagine di un prodotto come primo fotogramma e genera brevi clip il cui rapporto d'aspetto segue l'immagine fornita.

Spot video localizzati

Genera immagini, dialoghi, effetti sonori e rumore di fondo in un unico passaggio, quindi invia ogni risultato al tuo flusso di lavoro di localizzazione e revisione.

Sistemi di produzione UGC

Collega invii, monitoraggio dei lavori, callback, moderazione e archiviazione delle risorse in una pipeline automatizzata per contenuti di breve durata.
Limiti, routing del modello, fatturazione, audio e relazione con la piattaforma.

FAQ API MiniMax H3

Quale durata accetta l'API di MiniMax H3?

Sia hailuo_h3 che hailuo_h3_refs accettano qualsiasi numero intero compreso tra 5 e 15 secondi, con un valore predefinito di 5. I valori non interi o fuori intervallo vengono rifiutati prima della detrazione dei token.

Perché esistono due ID modello H3?

MiniMax tratta il controllo dei fotogrammi e il materiale di riferimento come mutuamente esclusivi. GoEnhance espone quindi hailuo_h3 per flussi di lavoro basati su primo/ultimo fotogramma e hailuo_h3_refs per la generazione basata su riferimenti, evitando di combinare parametri in conflitto durante l'esecuzione.

480p e 720p sono livelli di output ufficiali di MiniMax?

No. MiniMax produce ufficialmente solo 2K. I livelli 480p e 720p su hailuo_h3 vengono eseguiti sulla pipeline di GoEnhance. Ti consentono di iterare in modo più economico, utilizzando il 2K solo per le riprese che decidi di conservare.

Perché hailuo_h3_refs costa di più?

hailuo_h3_refs funziona solo tramite il canale ufficiale di MiniMax. Le risoluzioni disponibili sono 768P e 2K, con tariffe al secondo rispettivamente di $0,099 e $0,143.

Come funziona la fatturazione?

L'utilizzo si basa sui token: $10 equivalgono a 500 token, ovvero $0,02 per token. La fatturazione video avviene al secondo secondo la tariffa indicata. I punti vengono detratti una volta al momento dell'invio dell'attività e rimborsati integralmente se la generazione fallisce.

MiniMax H3 genera audio?

Sì. H3 genera dialoghi stereo nativi, effetti sonori e rumore d'ambiente nello stesso passaggio del video, invece di aggiungere un doppiaggio in un secondo momento.

Come faccio a sapere quando un video è pronto?

Salva l'img_uuid restituito ed effettua il polling dell'endpoint dei dettagli del lavoro, oppure registra un URL di callback. Il callback di avvio utilizza status=0; un callback terminale contiene il risultato.

L'API aperta di GoEnhance è affiliata a MiniMax o Hailuo?

No. L'API aperta di GoEnhance è una piattaforma API di terze parti indipendente. Non è MiniMax o Hailuo e non è affiliata o approvata da MiniMax. I nomi identificano il modello e appartengono ai rispettivi proprietari.

Dov'è l'editor no-code di MiniMax H3?

Questa pagina è destinata all'integrazione REST API. Per un editor rivolto ai consumatori, visita la pagina del modello video MiniMax H3.

Avvia la tua integrazione API MiniMax H3