MiniMax H3 APIMiniMax-H3 · API zur Videogenerierung · minimaxh3.video

MiniMax H3 API für produktionsreife Videogenerierung

Entwickle mit der MiniMax H3 API Workflows für Text-zu-Video, die Steuerung von Anfangs- und Endbild sowie Omni-Referenzen. Der asynchrone Ablauf liefert zunächst eine task_id und anschließend eine URL zum Herunterladen des Videos.

Generator öffnen Prompt-Guide lesen

POST /api/v1/video_generation200 · task_id

curl --request POST \
  --url https://minimaxh3.video/api/v1/video_generation \
  --header "Authorization: Bearer $MINIMAX_H3_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "Ein Radfahrer überquert eine regennasse Stadtstraße bei Nacht, Neonreflexionen auf nassem Asphalt, Kamera fährt neben dem Fahrrad mit."
      }
    ],
    "duration": 5,
    "resolution": "2K",
    "ratio": "16:9"
  }'

Endpunkt: POST /api/v1/video_generation

Modell-ID: MiniMax-H3

Workflow: Asynchroner Auftrag

Output: 2K · 4–15s

Auth: Bearer-API-Schlüssel

Prompt-Limit: 7.000 Zeichen

Öffentliche API-Schnittstelle

Ein MiniMax H3-Endpunkt, drei kreative Modi.

MiniMax-H3 verwendet ein multimodales content-Array. Die zugewiesenen Rollen legen fest, ob die Anfrage Text-zu-Video, Bild-zu-Video mit Anfangs- und Endbild oder referenzbasierte Videogenerierung nutzt.

01content: text

Text zu Video (t2va)

Sende das erforderliche Textelement, um die gesamte Szene generieren zu lassen. Bei reiner Textgenerierung ist ratio Pflicht und darf nicht adaptive sein.

02content: text + images

Anfangs- / Endbild (i2va)

Füge image_url-Elemente mit der Rolle first_frame und optional last_frame hinzu, um die Bildkomposition am Anfang und Ende zu steuern.

03content: text + refs

Referenzgenerierung (r2va)

Steuere Figuren, Bewegung, Kamera, Stil oder Stimme mit Referenzbildern, -videos und -audio, ohne sie mit den Rollen für Anfangs- und Endbild zu kombinieren.

Was die API bereitstellt

Steuere Szene, Referenzen und Ausgabe gezielt.

MiniMax H3 ist als offenes, vielseitiges multimodales Videomodell dokumentiert. Die V2-API ist für produktive Backends konzipiert, nicht nur für einzelne Tests in einer Spielwiese.

Multimodale Eingabe

Text, Bild, Video und Audio in einer Anfrage

Jedes Content-Element ist typisiert und kann eine Rolle tragen. Audio-Referenzen müssen mit Bild- oder Video-Eingaben gesendet werden.

Ausgabeumfang

4–15 Sekunden nativ in 2K

duration akzeptiert ganzzahlige Sekundenwerte von 4 bis 15. Gängige Seitenverhältnisse werden unterstützt; adaptive ist zulässig, wenn das Eingabemedium die Bildgeometrie vorgibt.

Prompt-Budget

Bis zu 7.000 Zeichen für deine Regieanweisung

Nutze den Platz für den Aufbau der Einstellung, Bewegung, Kameraführung, Dialogabsicht und die Zuordnung von Referenzen – nicht für eine bloße Aneinanderreihung von Keywords.

Rollenkonflikte

Anfangs-/Endbild und Referenzen schließen sich aus

Sobald eine reference_*-Rolle verwendet wird, dürfen first_frame und last_frame nicht vorkommen. Eine entsprechende Validierung verhindert unnötige 400-Fehler.

Async-Ergebnis

task_id → status → content.url

Erfolgreiche Aufträge liefern in der Statusantwort direkt eine zeitlich begrenzte Download-URL. Speichere die Kennungen und sichere die Datei dauerhaft, falls sie später noch verfügbar sein muss.

Auftragsverwaltung

Auflisten, abbrechen und Ablaufzeiten beachten

V2 dokumentiert das Auflisten sowie cancel/delete und sieht für aktuelle Aufträge nur ein kurzes Abfragefenster vor. Behandle jede Generierung daher als verwalteten Auftrag, nicht als einen einzigen langen HTTP-Aufruf.

Einsatzbereiche

Was Teams mit der MiniMax H3 API entwickeln

Nutze denselben asynchronen Workflow für einzelne kreative Assets, Creator-Tools oder Batch-Pipelines.

Creator-Produkte

Aufnahmen direkt in der App generieren

Lass Nutzer einen Prompt oder First Frame einreichen, zeige den Warteschlangenstatus und liefere bei Erfolg einen 2K-Clip.

Markensysteme

Referenzgeleitete Kampagnen

Übernimm Figuren-, Produkt-, Bewegungs- oder Stimmreferenzen in mehrere kurze Einstellungen, ohne die Identität jedes Mal neu aufbauen zu müssen.

Editorial-Tools

First-to-Last-Übergänge

Steuere einen kontrollierten Eröffnungs- und Schlussframe, wenn Storyboard-Kontinuität wichtiger ist als reine Improvisation.

Social-Pipelines

Vertikale und filmische Seitenverhältnisse

Generiere 9:16-Aufmacher oder 16:9-Masteraufnahmen über dieselbe Schnittstelle und variiere lediglich ratio und duration.

Agent-Backends

Warteschlangenbasierte multimodale Jobs

KI-Agenten können content-Arrays zusammenstellen, den Status abfragen und content.url an Speicher-, Moderations- oder Bearbeitungsschritte übergeben.

Prototyp-Studios

Schnelle Regietests

Teste Kombinationen aus Kamera, Darstellung und Referenzen, bevor du eine vollständige Produktionspipeline aufbaust.

Asynchroner Workflow

Vom API-Schlüssel zum herunterladbaren MiniMax H3-Video

Für die Generierung muss keine HTTP-Anfrage dauerhaft offen bleiben. Speichere die Kennungen und führe die dokumentierten V2-Schritte aus.

Erstellen

Generierungsauftrag übermitteln

Übermittle per POST model MiniMax-H3, ein content-Array sowie duration, resolution und bei Bedarf ratio. Eine erfolgreiche Antwort enthält task_id.

POST /api/v1/video_generation

Beobachten

Auftragsstatus abfragen

Frage den Auftrag ab, bis er einen Endstatus erreicht. queued und running sind reguläre Zwischenzustände.

GET /api/v1/video_generation/{task_id}

Abrufen

content.url herunterladen

Im Status succeeded enthält die Antwort content.url. Die URL ist zeitlich begrenzt. Kopiere die Datei daher in einen eigenen Speicher, wenn sie dauerhaft verfügbar bleiben soll.

content.url · mp4

Aufbau der Anfrage

Diese Felder sorgen für eine zuverlässige MiniMax-H3-Anfrage

Formuliere die Anfrage eindeutig und validiere modusspezifische Kombinationen, bevor du einen Auftrag übermittelst.

Erforderlich

model

Verwende die exakt dokumentierte Kennung MiniMax-H3. Nutze keine Produktbezeichnungen als Modell-ID.

Erforderlicher multimodaler Inhalt

content[]

Mindestens ein type=text-Element. Füge image_url-, video_url- oder audio_url-Elemente mit Rollen für gesteuerte Modi hinzu.

4–15 ganze Sekunden

duration

Wähle einen ganzzahligen Sekundenwert. Eine längere Dauer ist nicht immer besser, wenn die Einstellung nur eine klare Aktion zeigen soll.

Dokumentierte Ausgabe

resolution

MiniMax H3 ist mit 2K-Ausgabe dokumentiert. Prüfe die aktuellen Enum-Werte vor der Veröffentlichung anhand der jeweils gültigen API-Referenz.

Geometriesteuerung

ratio

Erforderlich für reines Text-zu-Video und darf in diesem Modus nicht adaptiv sein. Bildgeführte Workflows können der Quellgeometrie folgen.

Optionale Medienrollen

first_frame · last_frame · reference_*

Die Rollen bestimmen die Art der kreativen Steuerung. Prüfe beim Upload, ob sich Rollen ausschließen und ob jede Datei innerhalb der Größenlimits liegt.

Auftragsstatus

Behandle den Status als Zustandsautomaten

Clients müssen Zwischenzustände tolerieren und die Abfrage erst bei einem dokumentierten Endstatus beenden.

Status	Bedeutung	Empfohlenes Anwendungsverhalten
queued	Wartet auf Kapazität	task_id speichern und die Abfrageintervalle schrittweise verlängern
running	Generierung läuft	Job sichtbar halten; doppelte Einreichungen vermeiden
succeeded	Video ist bereit	content.url lesen und Asset speichern
failed	Generierung nicht abgeschlossen	Fehlercode und -meldung anzeigen und einen gezielten erneuten Versuch ermöglichen
cancelled	Auftrag wurde abgebrochen	Auftragsansicht schließen und den Vorgang protokollieren
expired	Auftrag nicht mehr verfügbar	Nicht ewig abfragen; bei Bedarf neu erstellen

Nur kürzlich erstellte Aufträge bleiben abfragbar. Prüfe die offizielle Aufbewahrungsfrist, bevor du Wiederherstellungsabläufe für längere Zeiträume entwirfst.

Eingabegrenzen

Validiere Medien, bevor sie MiniMax H3 erreichen

Die dokumentierten Grenzwerte lassen sich bereits beim Upload prüfen und verhindern so unnötige Fehler bei der Generierung.

Bilder

JPG, JPEG, PNG, WEBP, HEIC, HEIF · ≤ 30 MB

Breite und Höhe jeweils in [256, 5760]; Seitenverhältnis zwischen 2:5 und 5:2. Anfangsbild ≤ 1, Endbild ≤ 1, Referenzbilder ≤ 9.

Videos

MP4/MOV mit H.264/H.265 · ≤ 50 MB je Datei

Bis zu 3 Referenzclips, je 2–15s, gesamt ≤ 15s. Audio im Video kann AAC oder MP3 sein.

Audio

WAV oder MP3 · ≤ 15 MB je Datei

Bis zu 3 Clips, je 2–15s, gesamt ≤ 15s. Audio kann nicht allein gesendet werden – kopple es mit Bild- oder Video-Referenzen.

Gemischte Referenzen

Höchstens 12 Mediendateien pro Anfrage

Der Request-Body sollte höchstens 64 MB groß sein. Verwende für große Dateien bevorzugt öffentliche URLs statt Base64.

Unvereinbare Modi

Anfangs-/Endbild nicht mit Referenzrollen kombinieren

Wähle entweder die Kompositionssteuerung mit first_frame/last_frame oder die Omni-Referenzgenerierung, niemals beides in demselben content-Array.

Prompt

Regieanweisung auf höchstens 7.000 Zeichen begrenzen

Ordne Referenzen im Text zu, wenn Identität, Stimme oder Bewegung einem bestimmten Asset folgen müssen.

Preise findest du auf der Preisseite

Credit-Preise und Tariflimits können sich ändern. Verweise deshalb auf die aktuelle MiniMax H3-Preisseite, statt einen Betrag fest in die Integration einzubauen.

Geeignete Architekturen

Wann sich die asynchrone MiniMax H3-Generierung eignet

Wähle die V2-API, wenn dein Produkt einen Auftrag anlegen und auf die generierte Datei warten kann.

Gut geeignet

Backend-Services und Creator-Tools

Warteschlangen, dauerhafter Speicher und Statusanzeigen lassen sich direkt auf Workflows mit task_id abbilden.

Gut geeignet

Multimodale kreative Steuerung

Aufnahmen, die eine Regieanweisung mit Anfangsbild, Endbild oder Referenzmedien kombinieren.

Grenze

Kein Echtzeit-Streaming-Video-Socket

Plane Statusabfragen oder interne Worker ein, statt während der Generierung eine Live-Verbindung offen zu halten.

Grenze

Für Aufträge statt für offene Verbindungen konzipieren

Verwalte länger laufende Generierungen in der Backend-Warteschlange und zeige ihren Status in der Produktoberfläche an.

API-Fragen

MiniMax H3 API-Fragen

Praktische Antworten, bevor du deine erste Anfrage für den Produktivbetrieb integrierst.

Ist MiniMax-H3 die Modell-ID für diese API?

Ja. Übermittle beim Erstellen eines Auftrags model MiniMax-H3 an den Endpunkt zur MiniMax H3-Videogenerierung.

Welchen Endpunkt soll ich aufrufen?

Erstelle Aufträge mit POST https://minimaxh3.video/api/v1/video_generation und frage ihren Status anschließend mit GET https://minimaxh3.video/api/v1/video_generation/{task_id} ab. Lade nach erfolgreicher Generierung die MP4-Datei über content.url herunter.

Wie unterscheidet sich MiniMax H3 von der Hailuo 2.3-Integration?

H3 ist das aktuelle vielseitige multimodale Modell mit einer content[]-Schnittstelle, dokumentierter 2K-Ausgabe, 4–15 Sekunden Dauer und Omni-Referenzen. Hailuo 2.3 gehört zu einer früheren Modellfamilie mit anderen Anfrageformaten.

Kann ich die Steuerung über ein Anfangsbild mit Referenzaudio kombinieren?

Nicht in derselben Anfrage. Die Rollen first_frame/last_frame und reference_* schließen sich gegenseitig aus. Wähle den Modus, der zu deiner gewünschten Steuerung passt.

Wie authentifiziere ich mich?

Sende einen Bearer-API-Schlüssel im Authorization-Header. Sobald dein Zugang freigeschaltet ist, kannst du die Schlüssel in den MiniMax H3-Kontoeinstellungen erstellen und verwalten.

Wo finde ich die aktuellen Preise?

Die aktuellen Tarife und Credits findest du auf der Preisseite. Für die API-Nutzung gelten dieselben dort veröffentlichten Regeln für das Credit-Guthaben.

Bereit für die MiniMax H3-Integration

Teste die Aufnahme. Sende die API-Anfrage.

Entwickle die kreative Richtung im Generator und rufe anschließend mit deinem Schlüssel die MiniMax H3 API auf minimaxh3.video auf.

Generator öffnen Prompt-Guide lesen