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
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.
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.
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.
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 <code>POST https://api.goenhance.ai/api/v1/videos/generations</code> gesendet. Die Antwort liefert eine <code>img_uuid</code>; die Generierung läuft asynchron weiter.
Dauer und Prompt bei hailuo_h3
<code>duration</code> 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. <code>prompt</code> 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 <code>ratio</code> die Werte 21:9, 16:9, 4:3, 1:1, 3:4 oder 9:16. Liefert <code>image_url</code> einen ersten Frame, richtet sich die Ausgabe nach diesem Bild und der Parameter ratio wird nicht verwendet.
Frame-Eingaben bei hailuo_h3
Übergeben Sie <code>image_url</code> für den ersten Frame und optional <code>image_end_url</code> 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 <code>ref_imgs</code>, 3 Videos in <code>ref_videos</code> und 3 Audioclips in <code>ref_audios</code> 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 <a href="/billing">Preisstufen und Guthaben</a>.
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.
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.