MiniMax H3 API für Videogenerierung

Nutzen Sie MiniMax H3 über die unabhängige GoEnhance Open API. Schicken Sie Text, Frame-Bilder oder Referenzmaterial an einen asynchronen REST-Workflow, erhalten Sie eine img_uuid und pollen Sie anschließend das Ergebnis oder registrieren Sie einen Callback. H3 erzeugt nativen Stereoton – Dialog, Soundeffekte und Raumatmosphäre – im selben Durchlauf wie das Bild.
API-Key erstellen
Regisseur neben einer Kinokamera in einem professionell ausgeleuchteten Studio

Das H3-Modell passend zu Ihren Eingaben wählen

hailuo_h3: Text, erster Frame oder erster und letzter Frame

Verwenden Sie hailuo_h3 für Text-zu-Video, für Bild-zu-Video mit image_url oder für die Steuerung von erstem und letztem Frame mit dem optionalen image_end_url. Der Prompt ist Pflicht und darf bis zu 7.000 Zeichen lang sein. Siehe Playground und vollständige Parameterreferenz.
Creator bei einem Produktfilm-Dreh mit professioneller Kamera- und Lichttechnik

hailuo_h3_refs: referenzbasierte Generierung

Verwenden Sie hailuo_h3_refs, wenn eine einzelne Anfrage bis zu 9 Referenzbilder, 3 Referenzvideos und 3 Referenz-Audioclips braucht. Diese Route läuft über den offiziellen Kanal von MiniMax und liefert 768P und 2K. Siehe Endpunkt für Referenz-zu-Video.
hailuo_h3_refs: referenzbasierte Generierung

Unabhängiger, einheitlicher API-Zugang

Die GoEnhance Open API ist eine unabhängige Drittanbieter-Plattform, die einheitlichen Zugang zu Video- und Bildmodellen bietet. Sie ist weder MiniMax noch Hailuo, steht in keiner Verbindung zu MiniMax und wird von MiniMax nicht unterstützt oder empfohlen. MiniMax und Hailuo sind Marken ihrer jeweiligen Inhaber und werden hier ausschließlich zur Bezeichnung des Modells verwendet.
Unabhängiger, einheitlicher API-Zugang
Prüfen Sie diese Felder vor dem Absenden, damit ungültige Anfragen abgewiesen werden, bevor Tokens abgezogen werden.

MiniMax H3 API: Parameter und Limits

Gemeinsamer Endpunkt, asynchrone Antwort

Beide Modelle werden an POST https://api.goenhance.ai/api/v1/videos/generations gesendet. Die Antwort liefert eine img_uuid; die Generierung läuft asynchron weiter.

Dauer und Prompt bei hailuo_h3

duration muss eine ganze Zahl von 5 bis 15 Sekunden sein, Standardwert ist 5. Nicht ganzzahlige oder außerhalb des Bereichs liegende Werte werden abgewiesen, bevor Tokens abgezogen werden. prompt ist Pflicht und nimmt bis zu 7.000 Zeichen auf.

Auflösung und Seitenverhältnis bei hailuo_h3

Wählen Sie 480p, 720p oder 2K. Nur bei Text-zu-Video akzeptiert ratio die Werte 21:9, 16:9, 4:3, 1:1, 3:4 oder 9:16. Liefert image_url einen ersten Frame, richtet sich die Ausgabe nach diesem Bild und der Parameter ratio wird nicht verwendet.

Frame-Eingaben bei hailuo_h3

Übergeben Sie image_url für den ersten Frame und optional image_end_url für den letzten. Diese eine Modell-ID deckt Text-zu-Video, Bild-zu-Video und die Generierung mit erstem und letztem Frame ab.

Referenzeingaben bei hailuo_h3_refs

Eine einzelne Anfrage nimmt bis zu 9 Bilder in ref_imgs, 3 Videos in ref_videos und 3 Audioclips in ref_audios auf. Die Dauer ist eine ganze Zahl von 5 bis 15 Sekunden mit Standardwert 5; die Auflösung ist 768P oder 2K.

Nativer Stereoton

H3 erzeugt Dialog, Soundeffekte und Raumatmosphäre als nativen Stereoton im selben Durchlauf wie das Bild, statt den Ton nachträglich zu vertonen.
Die Kosten pro Aufruf ergeben sich aus dem Sekundenpreis der gewählten Stufe multipliziert mit der angeforderten Ausgabedauer. Videomodelle werden pro Sekunde Ausgabe abgerechnet.

MiniMax H3: Preis pro Sekunde

hailuo_h3 — 480p: $0.030 pro Sekunde

Eine GoEnhance-Pipeline-Stufe für günstigere Prompt-Iterationen. Keine offiziell von MiniMax unterstützte Ausgabestufe.

hailuo_h3 — 720p: $0.060 pro Sekunde

Eine GoEnhance-Pipeline-Stufe, um günstiger zu iterieren, bevor Sie die finalen Takes auswählen. Keine offiziell von MiniMax unterstützte Ausgabestufe.

hailuo_h3 — 2K: $0.090 pro Sekunde

Nutzen Sie die 2K-Stufe für ausgewählte Takes, die die offizielle Ausgabeauflösung von MiniMax brauchen.

hailuo_h3_refs — 768P: $0.099 pro Sekunde

Referenzbasierte Generierung läuft über den offiziellen Kanal von MiniMax und nutzt deshalb andere Stufen und Preise.

hailuo_h3_refs — 2K: $0.143 pro Sekunde

Die 2K-Stufe des offiziellen Kanals für referenzbasierte Anfragen.

Tokens, Erstattungen und Parallelität

Die Nutzung wird in Tokens abgerechnet: $10 ergeben 500 Tokens, also $0.02 pro Token. Punkte werden einmalig beim Absenden abgezogen und bei fehlgeschlagener Generierung vollständig erstattet. Die Parallelität hängt vom Build Tier des Kontos ab und beginnt bei 3 gleichzeitig laufenden Aufgaben. Siehe Preisstufen und Guthaben.

Die MiniMax H3 Video-API integrieren

1

1. API-Key erstellen und schützen

Erstellen Sie einen Key unter /keys. Senden Sie ihn als Authorization: Bearer <API key> und geben Sie ihn niemals in Browser-Code oder Logs preis.
2

2. Modell wählen und Anfrage validieren

Wählen Sie hailuo_h3 für Text oder Frame-Steuerung und hailuo_h3_refs für Referenzmaterial. Prüfen Sie vor dem Absenden Dauer, Auflösung, ob ratio anwendbar ist, Prompt-Länge und die Anzahl der Eingaben.
3

3. Absenden und img_uuid speichern

Senden Sie die Anfrage per POST an https://api.goenhance.ai/api/v1/videos/generations. Speichern Sie die zurückgegebene img_uuid in Ihrem eigenen Job-Datensatz, denn die Aufgabe läuft asynchron.
4

4. Pollen oder Callbacks empfangen

Pollen Sie GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=... oder registrieren Sie eine Callback-URL. Sobald die Aufgabe startet, wird ein Callback mit status=0 ausgelöst; der abschließende Callback enthält das Ergebnis.
5

5. Validierung, Fehler und Parallelität behandeln

Wiederholen Sie ungültige Dauern oder inkompatible Eingabekombinationen nicht unverändert. Fehlgeschlagene Generierungen werden vollständig erstattet. Stellen Sie neue Anfragen in eine Warteschlange, sobald die laufenden Aufgaben die durch Ihr Build Tier erlaubte Parallelität erreichen.
API-Key erstellen
Bauen Sie wiederholbare Medien-Pipelines rund um asynchrone Jobs, nativen Ton und explizite Frame- oder Referenzeingaben.

Was Entwickler mit H3 bauen

Programmatische Werbevarianten

Erzeugen Sie aus strukturierten Prompts ganze Serien kurzer Kampagnenideen und behalten Sie nur die freigegebenen Ergebnisse.

Pipelines für Produktclips

Nutzen Sie ein Produktbild als ersten Frame und erzeugen Sie kurze Clips, deren Seitenverhältnis sich nach diesem Bild richtet.

Lokalisierte Video-Spots

Erzeugen Sie Bild, Dialog, Soundeffekte und Raumatmosphäre in einem Durchlauf und leiten Sie jedes Ergebnis durch Ihren Lokalisierungs- und Freigabeprozess.

Systeme für UGC-Produktion

Verbinden Sie Einreichungen, Job-Tracking, Callbacks, Moderation und Asset-Speicherung zu einer automatisierten Pipeline für Kurzvideos.
Limits, Modellwahl, Abrechnung, Ton und das Verhältnis zur Plattform.

MiniMax H3 API: häufige Fragen

Welche Dauer akzeptiert die MiniMax H3 API?

Sowohl hailuo_h3 als auch hailuo_h3_refs akzeptieren jede ganze Zahl von 5 bis 15 Sekunden, Standardwert ist 5. Nicht ganzzahlige oder außerhalb des Bereichs liegende Werte werden abgewiesen, bevor Tokens abgezogen werden.

Warum gibt es zwei H3-Modell-IDs?

MiniMax behandelt Frame-Steuerung und Referenzmaterial als sich gegenseitig ausschließend. Deshalb stellt GoEnhance hailuo_h3 für Workflows mit erstem und letztem Frame und hailuo_h3_refs für referenzbasierte Generierung bereit, statt Parameter zu kombinieren, die zur Laufzeit kollidieren.

Sind 480p und 720p offizielle MiniMax-Ausgabestufen?

Nein. MiniMax gibt offiziell nur 2K aus. Die Stufen 480p und 720p bei hailuo_h3 laufen auf GoEnhances eigener Pipeline. Damit iterieren Sie günstiger und setzen 2K nur für die Takes ein, die Sie behalten.

Warum kostet hailuo_h3_refs mehr?

hailuo_h3_refs läuft ausschließlich über den offiziellen Kanal von MiniMax. Verfügbar sind die Auflösungen 768P und 2K mit Sekundenpreisen von $0.099 beziehungsweise $0.143.

Wie funktioniert die Abrechnung?

Die Abrechnung erfolgt über Tokens: $10 ergeben 500 Tokens, also $0.02 pro Token. Videos werden pro Sekunde zum angegebenen Satz abgerechnet. Punkte werden einmalig beim Absenden der Aufgabe abgezogen und bei fehlgeschlagener Generierung vollständig erstattet.

Erzeugt MiniMax H3 auch Ton?

Ja. H3 erzeugt Dialog, Soundeffekte und Raumatmosphäre als nativen Stereoton im selben Durchlauf wie das Video, statt nachträglich zu vertonen.

Woran erkenne ich, dass ein Video fertig ist?

Speichern Sie die zurückgegebene img_uuid und pollen Sie den Job-Detail-Endpunkt oder registrieren Sie eine Callback-URL. Der Start-Callback nutzt status=0; der abschließende Callback enthält das Ergebnis.

Steht die GoEnhance Open API in Verbindung zu MiniMax oder Hailuo?

Nein. Die GoEnhance Open API ist eine unabhängige Drittanbieter-API-Plattform. Sie ist weder MiniMax noch Hailuo, steht in keiner Verbindung zu MiniMax und wird von MiniMax nicht unterstützt oder empfohlen. Die Namen bezeichnen lediglich das Modell und gehören ihren jeweiligen Inhabern.

Wo finde ich den No-Code-Editor für MiniMax H3?

Diese Seite richtet sich an die REST-API-Integration. Einen Editor für Endnutzer finden Sie auf der MiniMax H3 Videomodell-Seite.

Starten Sie Ihre MiniMax H3 API-Integration