---
title: "Gebruik Hailuo in Hermes Agent via RunAPI — Video-API-gids"
url: "https://runapi.ai/nl/hermes-hailuo.md"
canonical: "https://runapi.ai/nl/hermes-hailuo"
locale: "nl"
model: "hailuo"
---

# Gebruik Hailuo in Hermes Agent.

Hailuo is het videogeneratiemodel van MiniMax dat native 1080p-beeldmateriaal produceert met nauwkeurige fysicasimulatie in 6 varianten — Hailuo 02 en 2.3, elk met text-to-video- en image-to-video-endpoints in pro- en standaardniveaus. Hermes Agent roept het aan via RunAPI met de custom:runapi-provider — dezelfde sleutel en basis-URL die je voor chat hebt geconfigureerd.

## 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. **Configureer RunAPI** — Stel de omgevingsvariabele RUNAPI_API_KEY in. Als je RunAPI al als custom:runapi-provider in Hermes Agent voor chat hebt toegevoegd, werken dezelfde sleutel en base_url voor videogeneratie — geen extra configuratie nodig.
2. **Roep Hailuo text_to_video of image_to_video aan** — Stuur een POST-verzoek naar /api/v1/hailuo/text_to_video met model ingesteld op hailuo-02-text-to-video-pro en een scènebeschrijvende prompt. Voor afbeeldingsgestuurde video gebruik je het image_to_video-endpoint met first_frame_image_url om je brononderwerp te behouden.
3. **Haal het resultaat op** — Het endpoint retourneert onmiddellijk een task_id. Poll het taakstatusendpoint totdat de status verandert naar voltooid, haal dan de gegenereerde video-URL op uit de reactie. Doorlooptijd is doorgaans minder dan twee minuten voor het pro-niveau.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Verplicht. Eén van: 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` | Verplicht. Tekstbeschrijving van de videoscène, camerabeweging en belichting. |
| `first_frame_image_url` | `string` | Verplicht voor image_to_video-endpoints. URL van de bronafbeelding als eerste frame. |
| `last_frame_image_url` | `string` | Optioneel. URL van een afbeelding als laatste frame. Alleen beschikbaar op Hailuo 02 image-to-video. |
| `duration_seconds` | `integer` | Optioneel. Videolengte in seconden. Geaccepteerde waarden: 6 of 10. Standaard 10 bij standaard, vast bij pro. |
| `output_resolution` | `string` | Optioneel. Uitvoerresolutie. 512p of 768p voor 02 standaard; 768p of 1080p voor 2.3-varianten. |
| `callback_url` | `string` | Optioneel. Webhook-URL die een POST ontvangt wanneer de taak voltooid is. |

## FAQ

### Kan ik Hailuo gebruiken in Hermes Agent?

Ja. Configureer RunAPI als custom:runapi-provider in Hermes Agent en roep vervolgens het text_to_video- of image_to_video-endpoint aan met een Hailuo-modelslug. Dezelfde RUNAPI_API_KEY die je voor chat gebruikt, verwerkt videogeneratie.

### Wat is het verschil tussen Hailuo 02 en Hailuo 2.3?

Hailuo 02 ondersteunt zowel text-to-video als image-to-video met controle over het eerste en laatste frame. Hailuo 2.3 is alleen image-to-video maar biedt verbeterde lichaamsbeweging, micro-expressies en speciale anime- en illustratiestijlen.

### Hoe werkt duurgebaseerde facturering bij standaardniveaus?

Standaardniveau-prijzen variëren per duration_seconds. Voor text-to-video standaard kost een clip van 6 seconden 30 cent en een clip van 10 seconden 50 cent. Image-to-video standaardprijzen houden ook rekening met output_resolution — een 6s 512p-clip begint bij 12 cent.

### Verwerkt Hermes Agent de asynchrone polling automatisch?

Nee. Hailuo is asynchroon — de API retourneert onmiddellijk een task_id. Je Hermes Agent-workflow moet het taakstatusendpoint pollen of een callback_url opgeven. Generatietijd is doorgaans 60-120 seconden.

### Kan ik zowel het eerste als het laatste frame van een Hailuo-video bepalen?

Alleen op Hailuo 02 image-to-video-endpoints. Geef first_frame_image_url en last_frame_image_url samen mee om begin- en eindframes te definiëren. Hailuo 2.3 image-to-video accepteert alleen first_frame_image_url.


## Links

- [Hermes Agent-configuratiegids →](https://runapi.ai/nl/hermes-agent)
- [Hailuo-modellen →](https://runapi.ai/nl/models/hailuo)
- [Model catalog](https://runapi.ai/nl/models)
- [API docs](https://runapi.ai/nl/docs)