---
title: "Usa Hailuo in Hermes Agent tramite RunAPI — Guida API Video"
url: "https://runapi.ai/it/hermes-hailuo.md"
canonical: "https://runapi.ai/it/hermes-hailuo"
locale: "it"
model: "hailuo"
---

# 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.

## API example

```bash
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."
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "hailuo-02-text-to-video-pro"
}

```

## How it works

1. **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.
2. **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.
3. **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.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `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. |

## FAQ

### Posso usare Hailuo in 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.

### Qual è la differenza tra Hailuo 02 e Hailuo 2.3?

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.

### Come funziona la tariffazione basata sulla durata per i livelli standard?

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.

### Hermes Agent gestisce automaticamente il polling asincrono?

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.

### Posso controllare sia il primo che l'ultimo fotogramma di un video Hailuo?

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.


## Links

- [Guida di configurazione di Hermes Agent →](https://runapi.ai/it/hermes-agent)
- [Modelli Hailuo →](https://runapi.ai/it/models/hailuo)
- [Model catalog](https://runapi.ai/it/models)
- [API docs](https://runapi.ai/it/docs)