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
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.
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.
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.
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 <code>POST https://api.goenhance.ai/api/v1/videos/generations</code>. La risposta restituisce un <code>img_uuid</code>; la generazione continua in modo asincrono.
durata e prompt di hailuo_h3
<code>duration</code> 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. <code>prompt</code> è obbligatorio e accetta fino a 7.000 caratteri.
risoluzione e proporzioni di hailuo_h3
Scegli 480p, 720p o 2K. Solo per text-to-video, <code>ratio</code> accetta 21:9, 16:9, 4:3, 1:1, 3:4 o 9:16. Quando <code>image_url</code> fornisce un primo fotogramma, l'output segue quell'immagine e il parametro ratio non viene utilizzato.
input dei fotogrammi di hailuo_h3
Passa <code>image_url</code> per un primo fotogramma e <code>image_end_url</code> 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 <code>ref_imgs</code>, 3 video in <code>ref_videos</code> e 3 clip audio in <code>ref_audios</code>. 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 <a href="/billing">livelli di prezzo e i crediti</a>.
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 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.