Usa Hailuo in Hermes Agent.
Hailuo è il modello di generazione video di MiniMax che produce filmati nativi a 1080p con simulazione fisica accurata in 6 varianti — Hailuo 02 e 2.3, ciascuna con endpoint text-to-video e image-to-video nei livelli pro e standard. Hermes Agent lo chiama tramite RunAPI usando il provider custom:runapi — stessa key e base URL configurate per la chat.
Usa RunAPI per generare un video con MiniMax Hailuo 02 Pro tramite Hermes Agent.
Requisiti:
- Usa il provider custom:runapi già configurato in Hermes Agent
- Chiama l'endpoint RunAPI text_to_video su https://runapi.ai/api/v1/hailuo/text_to_video
- Imposta model su "hailuo-02-text-to-video-pro"
- La variabile d'ambiente RUNAPI_API_KEY fornisce l'autorizzazione
- Includi un prompt dettagliato che descriva il movimento della telecamera e la scena
- La risposta è asincrona — esegui il polling dell'endpoint di stato del task finché il task non si completa, poi recupera l'URL del video
curl -X POST https://runapi.ai/api/v1/hailuo/text_to_video \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo-02-text-to-video-pro",
"prompt": "A glass marble rolls across a wooden desk, catches the edge, and falls in slow motion. Camera follows the marble. Soft window light, shallow depth of field."
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "hailuo-02-text-to-video-pro"
}
Usa Hailuo in Hermes Agent in tre passaggi
Configura RunAPI
Imposta la variabile d'ambiente RUNAPI_API_KEY. Se hai già aggiunto RunAPI come provider custom:runapi in Hermes Agent per la chat, la stessa key e base_url funzionano per la generazione video — nessuna configurazione aggiuntiva necessaria.
export RUNAPI_API_KEY=runapi_xxx
Chiama Hailuo text_to_video o image_to_video
Invia una richiesta POST a /api/v1/hailuo/text_to_video con model impostato su hailuo-02-text-to-video-pro e un prompt che descriva la scena. Per video ancorato a un'immagine, usa l'endpoint image_to_video con first_frame_image_url per preservare il soggetto sorgente.
POST /api/v1/hailuo/text_to_video
Ottieni il risultato
L'endpoint restituisce immediatamente un task_id. Esegui il polling dell'endpoint di stato del task finché lo stato non cambia in completed, poi recupera l'URL del video generato dalla risposta. Il tempo di risposta tipico è inferiore a due minuti per il livello pro.
GET /api/v1/hailuo/text_to_video/tsk_abc123
Parametri API Hailuo
| Parametro | Tipo | Descrizione |
|---|---|---|
model |
string |
Obbligatorio. Uno tra: hailuo-02-text-to-video-pro, hailuo-02-text-to-video-standard, hailuo-02-image-to-video-pro, hailuo-02-image-to-video-standard, hailuo-2.3-image-to-video-pro, hailuo-2.3-image-to-video-standard. |
prompt |
string |
Obbligatorio. Descrizione testuale della scena video, del movimento della telecamera e dell'illuminazione. |
first_frame_image_url |
string |
Obbligatorio per gli endpoint image_to_video. URL dell'immagine sorgente usata come primo fotogramma. |
last_frame_image_url |
string |
Facoltativo. URL di un'immagine usata come ultimo fotogramma. Disponibile solo su Hailuo 02 image-to-video. |
duration_seconds |
integer |
Facoltativo. Durata del video in secondi. Valori accettati: 6 o 10. Predefinito a 10 per lo standard, fisso per il pro. |
output_resolution |
string |
Facoltativo. Risoluzione di output. 512p o 768p per lo standard 02; 768p o 1080p per le varianti 2.3. |
callback_url |
string |
Facoltativo. URL webhook che riceve una POST quando il task si completa. |
Cos'è Hailuo su Hermes Agent?
Hailuo di MiniMax offre la velocità di generazione più rapida nella sua classe con coerenza del movimento fluida e forte ritenzione dei dettagli. Tramite il provider custom:runapi di Hermes Agent, produce filmati nativi 1080p da testo o immagini, con Hailuo 2.3 che aggiunge stili di rendering dedicati per anime e illustrazioni. La sua velocità lo rende una scelta pratica per workflow che necessitano rapidamente di più varianti video.
Casi d'uso di Hailuo
Contenuto di canale YouTube senza volto
Generare riprese di stabilimento e sequenze visive per canali YouTube senza volto. Il rapido tempo di risposta di Hailuo e la qualità coerente dell'output lo rendono pratico per la produzione regolare di contenuto.
Clip di prodotti ed e-commerce
Creare video di presentazione dei prodotti con fisica realistica -- liquidi che scorrono, tessuti che cadono, oggetti che ruotano -- per le pagine di listino e gli annunci social.
Riprese di stabilimento e B-roll
Generare filmati di sfondo e clip di transizione per progetti video più lunghi. Hailuo gestisce il rendering dell'ambiente, gli effetti atmosferici e il movimento della camera in modo affidabile.
Domande su Hailuo + Hermes Agent
Sì. Configura RunAPI come provider custom:runapi in Hermes Agent, poi chiama l'endpoint text_to_video o image_to_video con uno slug di modello Hailuo. La stessa RUNAPI_API_KEY che usi per la chat gestisce la generazione video.
Hailuo 02 supporta sia text-to-video che image-to-video con controllo del primo e dell'ultimo fotogramma. Hailuo 2.3 è solo image-to-video ma aggiunge movimenti del corpo migliorati, micro-espressioni e stili di rendering dedicati per anime e illustrazioni.
Il prezzo del livello standard varia in base a duration_seconds. Per text-to-video standard, un clip da 6 secondi costa 30 centesimi e uno da 10 secondi costa 50 centesimi. Il prezzo dello standard image-to-video tiene conto anche di output_resolution — un clip da 6s a 512p parte da 12 centesimi.
No. Hailuo è asincrono — l'API restituisce immediatamente un task_id. Il workflow di Hermes Agent deve eseguire il polling dell'endpoint di stato del task o fornire un callback_url. Il tempo di generazione tipico è 60-120 secondi.
Solo sugli endpoint image-to-video di Hailuo 02. Passa first_frame_image_url e last_frame_image_url insieme per definire i fotogrammi iniziale e finale. Hailuo 2.3 image-to-video accetta solo first_frame_image_url.
Configurazione generale di Hermes Agent
Non ancora configurato? Inizia con la guida di configurazione RunAPI per Hermes Agent.
Guida di configurazione di Hermes Agent →Catalogo modelli Hailuo
Vedi tutte le varianti Hailuo, i livelli di prezzo e la documentazione API.
Modelli Hailuo →Prova Hailuo in Hermes Agent oggi.
Ottieni una API key RunAPI gratuita, configura il provider custom:runapi e inizia a generare video con MiniMax Hailuo.