MiniMax Hailuo 02 nutzen: Komplettanleitung

MiniMax Hailuo 02 ist ein leistungsstarkes KI-Modell für Videos in Kinoqualität, mit präziser Kontrolle über Bild, Bewegung und Effekte. Auf APIMart nutzen Sie es über die MiniMax Hailuo 02 API. Es unterstützt Text-zu-Video, Bild-zu-Video und Übergänge zwischen erstem und letztem Frame und erzeugt kurze, hochwertige Clips in Auflösungen bis 1080p. Das sollten Sie wissen:

• Hauptfunktionen: Videos aus Text-Prompts, einem Bild als erstem Frame oder einem Paar aus erstem und letztem Frame erstellen; Kamerabewegungen beschreiben Sie direkt im Prompt.
• Preise: Mit Stand Oktober 2026 kosten 1080p-Clips auf APIMart 0,08 $ pro Sekunde; aktuelle Preise finden Sie auf der Modellseite.
• Einrichtung: API-Schlüssel erzeugen, Anfrage mit Parametern aufbauen und Videos per asynchronem Polling abrufen.
• Einsatzbereiche: Ideal für Werbung, Produktpräsentationen, Storyboards und Schulungsvideos.

Erstellen Sie zum Start ein APIMart-Konto, sichern Sie Ihren API-Schlüssel und folgen Sie der Schritt-für-Schritt-Anleitung. Nutzen Sie konkrete Prompts und klare Kameraanweisungen, um die Videoqualität zu maximieren. Für längere Projekte setzen Sie mehrere Clips mit konsistenten Frames zusammen oder testen Kling V3 API als alternative filmische Generierung.

Das Wichtigste in Kürze

• MiniMax Hailuo 02 erzeugt über APIMart mit der Modell-ID MiniMax-Hailuo-02 Text-zu-Video-, Bild-zu-Video- und Übergangsclips vom ersten zum letzten Frame bis 1080p.
• Der Ablauf: APIMart-Konto erstellen, in API Key Management einen nur einmal angezeigten Schlüssel generieren, einen JSON-Body per POST an https://api.apimart.ai/v1/videos/generations senden und dann /v1/tasks/{task_id} alle 15–30 Sekunden abfragen, bis der Status completed ist.
• Wichtige Parameter sind prompt, duration mit 5 oder 10 Sekunden, resolution mit 512p, 768p oder 1080p, first_frame_image und last_frame_image als öffentliche URL oder Base64 sowie prompt_optimizer mit Standardwert true.
• Mit Stand Oktober 2026 kostet Hailuo 02 auf APIMart 0,0104 $ pro Sekunde bei 512p, 0,04 $ bei 768p und 0,08 $ bei 1080p; fertige Videos lesen Sie aus data.result.videos[0].url[0], Ergebnisse werden 72 Stunden aufbewahrt, also speichern Sie Dateien zeitnah.
• Auf APIMart unterstützt 1080p nur 5-Sekunden-Clips, und es gibt keinen nativen Ton; Videos über 10 Sekunden verketten Sie, indem Sie den letzten Frame als nächstes first_frame_image verwenden.

MiniMax Hailuo 02 auf einen Blick

Erste Schritte mit MiniMax Hailuo 02 auf APIMart

Kontoeinrichtung und API-Schlüssel

Gehen Sie zuerst auf apimart.ai und erstellen Sie ein Konto. Wenn Sie im Team arbeiten, können Sie bei APIMart eine Organisation einrichten. So teilen sich alle ein zentrales Guthaben, und niemand muss persönliche Zugangsdaten weitergeben.

Sobald das Konto bereit ist, laden Sie das gemeinsame Guthaben auf. Es gilt für alle Modelle auf APIMart, auch für High-End-Optionen wie Veo 3.1 API für professionelle Videogenerierung. Gehen Sie dann im Konsolen-Dashboard zum Bereich API Key Management und erzeugen Sie einen API-Schlüssel.

Wichtig: Ihr API-Schlüssel wird nur einmal angezeigt. Kopieren Sie ihn und bewahren Sie ihn sicher auf, etwa in einem Passwortmanager oder Secrets-Tresor. Laden Sie den Schlüssel im Code aus einer Umgebungsvariablen (z. B. APIMART_API_KEY), statt ihn direkt einzubetten. Das verringert das Risiko, ihn versehentlich offenzulegen, wenn Ihr Code geteilt oder in die Versionskontrolle hochgeladen wird. Jede API-Anfrage enthält diesen Schlüssel im Authorization-Header:

Authorization: Bearer YOUR_API_KEY

Für Teams ist die Organisationsfunktion ideal, um Zugriffe zentral zu verwalten, ohne individuelle Kontodaten zu teilen ^[2]. Mit dem API-Schlüssel können Sie Ihre Anfrageparameter konfigurieren und Videos erzeugen. Für alternative hochwertige Ergebnisse können Sie auch Grok Imagine Video API ausprobieren.

Wichtige Parameter für MiniMax-Hailuo-02-Anfragen

Sobald Ihr API-Schlüssel gesichert ist, bauen Sie die Anfrage mit den richtigen Parametern auf. Das Feld "model": "MiniMax-Hailuo-02" ist Pflicht, dazu kommen einige weitere. Hier die wichtigsten im Überblick:

Ein wichtiges Detail: Die Videogenerierung ist asynchron. Auf eine Anfrage antwortet die API mit einer task_id statt mit dem Video selbst. Sie fragen /v1/tasks/{task_id} alle 15–30 Sekunden ab, bis der Status "completed" lautet. Laden Sie das Video dann zeitnah herunter: Ergebnisse werden 72 Stunden aufbewahrt ^[1].

Mit den Parametern an Ort und Stelle können Sie sich auf einen wirkungsvollen Prompt konzentrieren, um MiniMax Hailuo 02 voll auszuschöpfen.

So schreiben Sie wirkungsvolle Prompts

Ein guter Prompt ist der Schlüssel zu hochwertigen Videos. Ein gut aufgebauter Prompt enthält sechs Elemente: Kameraeinstellung oder -bewegung, Motiv und Beschreibung, Handlung, Szene, Licht sowie Stil oder Stimmung. Statt einer vagen Beschreibung wie „eine Frau, die durch eine Stadt geht“ schreiben Sie lieber konkret: „Tracking Shot: Eine Frau im roten Mantel geht in der Abenddämmerung zügig durch eine regennasse Straße in Manhattan, Neonschilder spiegeln sich auf dem nassen Asphalt, filmischer Noir-Stil.“

Für dynamische Videos beschreiben Sie die Kamerabewegung am Anfang des Prompts in einfachen Worten, etwa „langsamer Push-in“, „Tracking Shot“ oder „statische Einstellung“. Die APIMart-Dokumentation für Hailuo 02 listet keine Kamerabefehle in eckigen Klammern auf; die 15 chinesischen Klammerbefehle, die später in dieser Anleitung vorkommen, sind für Hailuo 2.3 dokumentiert.

Bei komplexen Szenen lassen Sie prompt_optimizer auf true. Die Funktion verfeinert und erweitert Ihre Beschreibung automatisch und führt oft ohne viel Aufwand zu flüssigeren, stimmigeren Videos ^[1].

So erstellst du kinoreife KI-Videos in Hailuo 02

Schritt-für-Schritt-Anleitung: Videos mit MiniMax Hailuo 02 erzeugen

Eine einfache Text-zu-Video-Anfrage senden

Wenn API-Schlüssel und Prompt bereitstehen, ist die erste Anfrage einfach. Senden Sie einen POST-Aufruf an https://api.apimart.ai/v1/videos/generations, fügen Sie Ihr Bearer-Token in den Header ein und verwenden Sie einen JSON-Body wie diesen:

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "Tracking shot: a lone astronaut walks across a red desert at golden hour, dust swirling around their boots, cinematic wide-angle style.",
  "duration": 5,
  "resolution": "1080p"
}

Wichtig: Die Auflösung 1080p unterstützt nur 5-Sekunden-Clips. Für ein 10-Sekunden-Video müssen Sie auf 768p oder 512p herunter. Der Preis hängt von Auflösung und Dauer ab. Mit Stand Oktober 2026 kostet 768p 0,04 $ pro Sekunde und 1080p 0,08 $ pro Sekunde; aktuelle Preise finden Sie auf der Modellseite.

Nach dem Absenden liefert die API eine task_id in data[0].task_id und den Status submitted. Die Renderzeit hängt von Auflösung, Dauer und aktueller Auslastung ab, also fragen Sie weiter ab, bis der Task fertig ist.

So nutzen Sie die Bild-zu-Video-Funktion

Für Bild-zu-Video-Anfragen brauchen Sie einen zusätzlichen Parameter: first_frame_image. Das kann eine öffentliche URL (z. B. https://example.com/start.jpg) oder ein Base64-codierter Data-URL-String sein. Achten Sie darauf, dass das Bild die Vorgaben zu Dateityp, Größe und Seitenverhältnis erfüllt.

Ihr Prompt sollte die Bewegung beschreiben, nicht die visuellen Details der Szene, denn die liefert bereits das Bild. Zeigt Ihr Startbild etwa ein Produkt auf einem Tisch, sagt ein Prompt wie "Slow zoom in. Product rotates gently, soft studio lighting, clean white background" dem Modell, wie es animiert werden soll. Die Ausgabeauflösung richtet sich nach den Abmessungen Ihres Eingabebilds, daher ist eine hochwertige Vorlage für scharfe Ergebnisse entscheidend.

Für anspruchsvollere Effekte können Sie zusätzlich zu first_frame_image ein last_frame_image angeben. So entsteht ein Übergangsvideo zwischen zwei Bildern, ideal für Produkt-Reveals, Vorher-nachher-Vergleiche oder Szenenübergänge in größeren Projekten.

Sobald die Anfrage eingerichtet ist, verfolgen Sie die API-Antwort, um Ihr animiertes Video abzurufen. Für Projekte mit integriertem Ton lohnt sich ein Blick auf die Veo 3.1 API, die synchronisierten Ton erzeugt.

API-Antworten lesen und Ergebnisse herunterladen

Fragen Sie GET https://api.apimart.ai/v1/tasks/{task_id} ab. Wechselt der Status auf completed, steht die Video-URL in data.result.videos[0].url[0]. Eine separate Datei-ID oder einen Download-Endpunkt gibt es nicht. So läuft der Statusfluss:

Fragen Sie den Endpunkt /v1/tasks/{task_id} alle 15–30 Sekunden ab, bis der Status completed ist. Laden Sie das Video dann über die zurückgegebene URL herunter. Ergebnisse werden 72 Stunden aufbewahrt, speichern Sie die Datei also zeitnah in Ihrem eigenen Speicher ^[1].

In Python laden Sie das Video mit requests.get(video_url).content herunter und speichern es als .mp4-Datei, wobei video_url der Wert data["result"]["videos"][0]["url"][0] aus der Task-Antwort ist.

Prüfen Sie außerdem immer das Feld code in der API-Antwort. Der Wert 200 bedeutet, dass die Anfrage erfolgreich war, aber Sie müssen den Task-Status trotzdem auf mögliche Renderfehler überwachen ^[1].

Videoqualität verbessern und Workflows integrieren

Prompts und Parameter verfeinern

Um die Videoqualität zu steigern, strukturieren Sie Prompts nach diesem Muster: [Motiv & Handlung], [physisches/umgebungsbezogenes Element], [Kamerabewegung], [Licht/Atmosphäre], [Qualitätsangabe] ^[7]. Ein Beispiel: „Ein Barista gießt dampfende Milch in einen Espresso, die Flüssigkeit wirbelt in Zeitlupe, langsamer Zoom-in, warmes Café-Licht, filmische Qualität.“ So kann das Modell realistische Bewegung und Atmosphäre wirkungsvoller simulieren.

Wenn Sie explizite Kamera-Tags brauchen: MiniMax Hailuo 2.3 API auf APIMart unterstützt 15 chinesische Kamerabefehle in eckigen Klammern, die Sie mit den exakten Bezeichnungen an den Anfang des Prompts setzen ^[3]. Die Tabelle dient als Schnellreferenz:

Die Funktion prompt_optimizer ist standardmäßig aktiv und verbessert in der Regel die Ausgabequalität. Lassen Sie sie eingeschaltet, sofern das Modell nicht einem sehr spezifischen Skript folgen soll. Wenn Geschwindigkeit Vorrang hat und Sie mit etwas weniger Feinschliff leben können, setzen Sie fast_pretreatment: true, um die Vorverarbeitung zu verkürzen ^[1][6].

Sobald Prompts und Einstellungen sitzen, integrieren Sie sie in eine umfassendere Pipeline, um die Produktionsqualität zu steigern.

Multi-Modell-Pipelines mit APIMart aufbauen

Hailuo 02 funktioniert am besten zusammen mit ergänzenden Tools für Ton und längere Sequenzen. Es glänzt bei visuell dynamischem B-Roll-Material wie Wasser, Feuer oder Stoff, erzeugt aber keinen Ton. Um diese Lücke zu schließen, kombinieren Sie es in der Postproduktion mit MiniMax Audio-Tools, etwa Speech 2.8 für Voiceovers oder Music 2.6 für Soundtracks ^[8]. Für Marken- oder Werbeprojekte erzeugen Sie zuerst mit einem Bildmodell einen Basis-Frame und geben ihn dann als first_frame_image an Hailuo 02, um die Komposition präzise zu steuern ^[7].

Für Videos über 10 Sekunden nehmen Sie den letzten Frame eines fertigen Clips als Screenshot und verwenden ihn als first_frame_image für die nächste Anfrage. So bleiben Figurendetails und Umgebungslicht über mehrere Clips hinweg leichter konsistent ^[8].

Fehlerbehandlung und API-Best-Practices

Auch mit ausgefeilten Prompts und Pipelines können Probleme auftreten. Mit diesen Best Practices beheben Sie Fehler und optimieren API-Antworten wirkungsvoll.

Die beiden häufigsten Fehler bei Hailuo 02 sind nicht unterstützte Kombinationen aus Auflösung und Dauer und ungültige Bildeingaben. Prüfen Sie immer, ob Auflösung und Dauer zusammenpassen ^[1][6]. Für Bild-zu-Video-Tasks empfiehlt die MiniMax-eigene Dokumentation ein Quellbild unter 20 MB, mit einer kurzen Kante über 300 px und einem Seitenverhältnis zwischen 2:5 und 5:2, im Format JPG, PNG oder WebP ^[5].

Wenn ein Task fehlschlägt, prüfen Sie immer das Feld error in der Task-Antwort. Es liefert Details, mit denen Sie Probleme schnell lösen. In Produktionsumgebungen halten Sie das Abfrageintervall moderat und wiederholen mit exponentiellem Backoff; das reduziert unnötige API-Aufrufe und hält Ihren Workflow reaktionsschnell.

Fazit: Das Wichtigste

Hier eine kurze Zusammenfassung dessen, was MiniMax Hailuo 02 als Werkzeug für Videogenerierung auszeichnet.

MiniMax Hailuo 02 bietet Videoerstellung in Kinoqualität mit beeindruckender Präzision. Dank seiner NCR-Architektur mit dreimal so vielen Parametern und viermal so vielen Trainingsdaten wie frühere Modelle ^[7] erzeugt es sehr realistische Effekte für komplexe Elemente wie Wasser, Feuer, Rauch und Stoff.

Über APIMart kosten 768p 0,04 $ und 1080p 0,08 $ pro Sekunde (Stand Oktober 2026) ^[2], was es zu einer praktischen Wahl für alles von professioneller Produktion bis zum kreativen Experiment macht.

Zu den herausragenden Funktionen des Modells gehören:

• Bild-zu-Video-Werkzeuge für präzise Kontrolle.
• Kameraführung auf Prompt-Ebene (z. B. „Tracking Shot“, „langsamer Zoom-in“) für professionell wirkende Kameraarbeit.
• Kontinuität über den letzten Frame, für flüssige Übergänge in längeren Sequenzen.

Beachten Sie, dass 1080p-Clips auf APIMart auf 5 Sekunden begrenzt sind (die MiniMax-Ankündigung nennt 6 Sekunden). Für längere Videos ist 768p eine gute Alternative, mit 10-Sekunden-Clips zu einem niedrigeren Preis ^[1].

Mit diesen Funktionen bringt MiniMax Hailuo 02 Ihren Videoproduktions-Workflow auf das nächste Level.

FAQs

Wie erstelle ich Clips, die länger als 10 Sekunden sind?

MiniMax Hailuo 02 erlaubt maximal 10 Sekunden pro Clip, und 10-Sekunden-Clips erfordern 768p oder 512p (1080p unterstützt nur 5 Sekunden). Für längere Videos erzeugen Sie mehrere 10-Sekunden-Clips und verketten sie, indem Sie den letzten Frame eines Clips als first_frame_image des nächsten verwenden.

Für einen 10-Sekunden-Text-zu-Video-Clip geben Sie diese Parameter in Ihrer Anfrage an:

• duration: 10
• resolution: "768p"
• model: "MiniMax-Hailuo-02"

Fragen Sie den Task nach dem Absenden ab, bis er completed ist, und laden Sie das Video dann aus data.result.videos[0].url[0] herunter.

Was tun, wenn mein Task fehlschlägt?

Wenn Ihr Videogenerierungs-Task nicht durchgeht, prüfen Sie zuerst den HTTP-Status und das error-Objekt in der Antwort, um die Ursache einzugrenzen. Häufige Fälle:

• 400: Ungültige Parameter, etwa eine nicht unterstützte Kombination aus Auflösung und Dauer.
• 401: Authentifizierungsprobleme mit Ihrem API-Schlüssel.
• 402: Unzureichendes Guthaben auf Ihrem Konto.
• 429: Sie haben das Rate-Limit erreicht.

Bei Rate-Limit-Fehlern (HTTP 429) oder Serverproblemen (HTTP 5xx) setzen Sie exponentielles Backoff ein, also schrittweise längere Pausen zwischen den Wiederholungen. Prüfen Sie außerdem Ihre Eingabeparameter und achten Sie darauf, dass Ihre Prompts keine sensiblen Inhalte enthalten, um Validierungsfehler zu vermeiden.

Wie halte ich Figuren über mehrere Clips hinweg konsistent?

Für konsistente Figuren in MiniMax Hailuo 02 starten Sie jeden Clip mit einem klaren, gut ausgeleuchteten first_frame_image der Figur und verwenden den letzten Frame eines Clips als ersten Frame des nächsten. Bei mehreren Clips nehmen Sie passende Lichtdetails in Ihre Prompts auf. Für einen flüssigeren visuellen Fluss gleichen Sie die Kamerawinkel zwischen den Einstellungen an und nutzen in der Postproduktion dezente Übergänge wie Überblendungen oder Match Cuts. Diese Techniken helfen, eine stimmige und ausgefeilte Erzählung zu schaffen.