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.
RunAPI verwenden, um ein Video mit MiniMax Hailuo 02 Pro über Hermes Agent zu generieren.
Requirements:
- Use the custom:runapi provider already configured in Hermes Agent
- Call the RunAPI text_to_video endpoint at https://runapi.ai/api/v1/hailuo/text_to_video
- Set model to "hailuo-02-text-to-video-pro"
- The RUNAPI_API_KEY environment variable provides authorization
- Include a detailed prompt describing camera movement and scene
- The response is async — poll the task status endpoint until the task completes, then retrieve the video URL
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"
}
Hailuo in Hermes Agent in drei Schritten verwenden
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.
export RUNAPI_API_KEY=runapi_xxx
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.
POST /api/v1/hailuo/text_to_video
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.
GET /api/v1/hailuo/text_to_video/tsk_abc123
Hailuo API-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
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. |
Was ist Hailuo mit Hermes Agent?
Hailuo von MiniMax liefert die schnellste Generierungsgeschwindigkeit seiner Klasse mit glatter Bewegungskohärenz und starker Detailtreue. Über den Hermes-Agent-custom:runapi-Provider produziert es natives 1080p-Material aus Text oder Bildern, wobei Hailuo 2.3 dedizierte Anime- und Illustrationsrendering-Stile hinzufügt. Seine Geschwindigkeit macht es zu einer praktischen Wahl für Workflows, die schnell mehrere Videovarianten benötigen.
Hailuo Anwendungsfälle
Gesichtslloser YouTube-Kanal-Content
Establishing Shots und visuelle Sequenzen für gesichtslose YouTube-Kanäle generieren. Hailuos schnelle Durchlaufzeit und konsistente Ausgabequalität machen es für regelmäßige Content-Produktion praktisch.
Produkt- und E-Commerce-Clips
Produktpräsentationsvideos mit realistischer Physik erstellen – Flüssigkeiten fließen, Stoffe fallen, Objekte rotieren – für Listing-Seiten und Social Ads.
Establishing Shots und B-Roll
Hintergrundmaterial und Übergangsclips für längere Videoprojekte generieren. Hailuo verarbeitet Umgebungsrendering, atmosphärische Effekte und Kamerabewegung zuverlässig.
Hailuo + Hermes Agent — Fragen
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.
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.
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.
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.
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.
Hermes Agent Grundeinrichtung
Noch nicht eingerichtet? Mit der RunAPI-Einrichtungsanleitung für Hermes Agent starten.
Hermes Agent Einrichtungsanleitung →Hailuo in Hermes Agent noch heute ausprobieren.
Einen kostenlosen RunAPI-Key holen, den custom:runapi-Provider konfigurieren und mit MiniMax Hailuo Videos generieren.