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

# Hailuo in Hermes Agent verwenden.

Hailuo ist MiniMaxs Videogenerierungsmodell, das natives 1080p-Material mit präziser Physiksimulation über 6 Varianten produziert — Hailuo 02 und 2.3, jeweils mit Text-to-Video- und Image-to-Video-Endpunkten in Pro- und Standard-Stufen. Hermes Agent ruft es über RunAPI mit dem custom:runapi-Provider auf — derselbe Key und dieselbe Base-URL wie für 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. **RunAPI konfigurieren** — Die RUNAPI_API_KEY-Umgebungsvariable setzen. Wenn RunAPI bereits als custom:runapi-Provider in Hermes Agent für Chat hinzugefügt wurde, funktionieren derselbe Key und dieselbe base_url für die Videogenerierung — keine zusätzliche Konfiguration nötig.
2. **Hailuo text_to_video oder image_to_video aufrufen** — Einen POST-Request an /api/v1/hailuo/text_to_video mit model hailuo-02-text-to-video-pro und einem szenenbeschreibenden Prompt senden. Für bildverankerte Videos den image_to_video-Endpunkt mit first_frame_image_url verwenden, um das Quellmotiv beizubehalten.
3. **Ergebnis abrufen** — Der Endpunkt gibt sofort eine task_id zurück. Den Task-Status-Endpunkt abfragen, bis der Status auf completed wechselt, dann die generierte Video-URL aus der Antwort abrufen. Typische Bearbeitungszeit ist unter zwei Minuten für die Pro-Stufe.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Erforderlich. Eines von: 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` | Erforderlich. Textbeschreibung der Videosequenz, Kamerabewegung und Beleuchtung. |
| `first_frame_image_url` | `string` | Erforderlich für image_to_video-Endpunkte. URL des Quellbildes als ersten Frame. |
| `last_frame_image_url` | `string` | Optional. URL eines Bildes als letzten Frame. Nur bei Hailuo 02 Image-to-Video verfügbar. |
| `duration_seconds` | `integer` | Optional. Videolänge in Sekunden. Akzeptierte Werte: 6 oder 10. Standard ist 10 bei Standard, fest bei Pro. |
| `output_resolution` | `string` | Optional. Ausgabeauflösung. 512p oder 768p für 02 Standard; 768p oder 1080p für 2.3-Varianten. |
| `callback_url` | `string` | Optional. Webhook-URL, die einen POST erhält, wenn der Task abgeschlossen ist. |

## FAQ

### Kann ich Hailuo in Hermes Agent verwenden?

Ja. RunAPI als custom:runapi-Provider in Hermes Agent konfigurieren, dann den text_to_video- oder image_to_video-Endpunkt mit einem Hailuo-Modell-Slug aufrufen. Derselbe RUNAPI_API_KEY wie für Chat übernimmt die Videogenerierung.

### Was ist der Unterschied zwischen Hailuo 02 und Hailuo 2.3?

Hailuo 02 unterstützt Text-to-Video und Image-to-Video mit First-Frame- und Last-Frame-Steuerung. Hailuo 2.3 ist nur Image-to-Video, fügt aber verbesserte Körperbewegung, Mikroausdrücke und dedizierte Anime- und Illustrationsrenderstile hinzu.

### Wie funktioniert die dauerbasierte Preisgestaltung bei Standard-Stufen?

Standard-Stufen-Preise variieren nach duration_seconds. Für Text-to-Video Standard kostet ein 6-Sekunden-Clip 30 Cent und ein 10-Sekunden-Clip 50 Cent. Image-to-Video-Standard-Preise berücksichtigen auch output_resolution — ein 6s 512p-Clip beginnt bei 12 Cent.

### Übernimmt Hermes Agent das asynchrone Polling automatisch?

Nein. Hailuo ist asynchron — die API gibt sofort eine task_id zurück. Der Hermes Agent-Workflow muss den Task-Status-Endpunkt abfragen oder eine callback_url angeben. Typische Generierungszeit ist 60–120 Sekunden.

### Kann ich sowohl den ersten als auch den letzten Frame eines Hailuo-Videos steuern?

Nur bei Hailuo 02 Image-to-Video-Endpunkten. first_frame_image_url und last_frame_image_url zusammen übergeben, um Start- und Endframes zu definieren. Hailuo 2.3 Image-to-Video akzeptiert nur first_frame_image_url.


## Links

- [Hermes Agent Einrichtungsanleitung →](https://runapi.ai/de/hermes-agent)
- [Hailuo Modelle →](https://runapi.ai/de/models/hailuo)
- [Model catalog](https://runapi.ai/de/models)
- [API docs](https://runapi.ai/de/docs)