hailuo_2_3_fast, aggiungi facoltativamente un'immagine come primo fotogramma, quindi completa il processo asincrono tramite polling o callback.API Hailuo 2.3 Fast
Accedi a Hailuo 2.3 Fast tramite l'API indipendente di GoEnhance. Invia un prompt con l'ID modello esatto
Crea una Chiave API
Due Modalità di Generazione, un Solo Endpoint
Da Testo a Video
Invia il prompt richiesto e ometti image_url. Per la generazione da testo a video, usa ratio per richiedere l'inquadratura desiderata.
Da Immagine (Primo Fotogramma) a Video
Aggiungi un image_url pubblico come primo fotogramma. Il prompt rimane obbligatorio e dovrebbe descrivere il movimento, il comportamento della fotocamera e l'evoluzione della scena.
Valida le richieste rispetto al contratto live di GoEnhance prima dell'uso in produzione.
Funzionalità dell'API Hailuo 2.3 Fast
ID Modello MiniMax Esatto
Imposta <code>model</code> su <code>hailuo_2_3_fast</code>. Sia <code>model</code> che <code>prompt</code> sono obbligatori.
Input da Prompt o Primo Fotogramma
Ometti <code>image_url</code> per il testo a video, oppure fornisci un URL di immagine pubblico per avviare un processo da immagine a video.
Regole di Durata
Scegli 6 o 10 secondi. L'opzione 1080P supporta solo 6 secondi.
768P o 1080P
I valori di risoluzione documentati sono <code>768P</code> e <code>1080P</code>, con 768P come impostazione predefinita.
Rapporto per Testo a Video
Il campo facoltativo <code>ratio</code> controlla l'inquadratura per le richieste di testo a video.
Completamento Asincrono
Una risposta di invio riuscita restituisce <code>data.img_uuid</code> per il completamento basato su polling o callback.
Costo fisso per video generato, come attualmente indicato da GoEnhance a 0,02 $ per token.
Prezzi dell'API Hailuo 2.3 Fast
768P · 6 secondi
12,35 token per video, equivalenti a 0,247 $.
768P · 10 secondi
20,8 token per video, equivalenti a 0,416 $.
1080P · 6 secondi
21,45 token per video, equivalenti a 0,429 $. Un'opzione 1080P da 10 secondi non è documentata.
Integra Hailuo 2.3 Fast in tre passaggi
1
1. Crea la richiesta
Invia una richiesta POST a
https://api.goenhance.ai/api/v1/videos/generations con autenticazione bearer, model, prompt e le impostazioni opzionali valide. 2
2. Salva l'ID attività
Controlla la risposta HTTP insieme a
code e msg JSON. In caso di successo, conserva data.img_uuid. 3
3. Esegui il polling o ricevi i callback
Esegui il polling di
/api/v1/jobs/detail con l'ID attività o fornisci un custom_callback_url. I tentativi di invio del callback vengono ripetuti fino a tre volte quando l'endpoint non restituisce HTTP 200.Crea flussi di lavoro per video brevi tracciabili basati su una validazione esplicita della richiesta e uno stato asincrono.
Casi d'uso dell'API Hailuo 2.3 Fast
Iterazione creativa
Metti in coda bozze a 768P a basso costo prima di selezionare i prompt per le produzioni ad alta risoluzione.
Concetti di movimento del prodotto
Trasforma le immagini fisse del prodotto approvate in studi di movimento guidati dal primo fotogramma per la revisione.
Varianti di campagna
Invia prompt, durate e scelte di inquadratura alternativi come lavori separati tracciabili.
Previsualizzazione dello storyboard
Genera brevi studi di scena per la direzione della telecamera, il ritmo, l'illuminazione e l'atmosfera.
Pipeline di contenuti automatizzate
Collega la generazione a una coda di backend che memorizza gli ID attività e gestisce gli stati terminali.
Concetti verticali e orizzontali
Usa il campo del rapporto testo-video per puntare all'inquadratura richiesta da ciascuna superficie di distribuzione.
Risposte sull'utilizzo degli endpoint, sui prezzi, sugli input e sul completamento asincrono.