MiniMax

MiniMax H3

minimax-h3-max/text-to-video

Einheitliches multimodales Videomodell, das Text, Bilder, Videos und Audio in einem einzigen Kontext gleichzeitig verarbeitet, Text-zu-Video, Bild-zu-Video, referenzbasiertes Video und instruktionsgestützte Bearbeitung unterstützt und synchrones Audio erzeugen kann

minimax-h3 minimax-h3-max/image-to-video minimax-h3-max/text-to-video

minimax-h3-max/text-to-video ausprobieren

Eingabe

Galerie

Alle Arbeiten ansehen

Ausgabe

video

Fülle die Parameter aus und generiere – die Ergebnisse erscheinen hier.

Preise

minimax-h3-max/text-to-video per second

Spezifikationen	Einzelpreis
480P	$0.072
768P	$0.115
1080P	$0.229

Positionierung und Kurzüberblick

minimax-h3-max/text-to-video ist ein textgesteuerter Videoerzeugungs-Pfad von MiniMax für Text-zu-Video-Szenarien: Es genügt eine natürlichsprachige Eingabeaufforderung, um einen kurzen Videoclip mit synchroner Tonspur zu erzeugen. Die Strecke unterstützt eine maximale Dauer von 15 Sekunden, Auflösungen von 480P bis 1080P sowie sechs Bildseitenverhältnisse und bietet Prompt-Erweiterung sowie austauschbares Ziel-Audio. Sie eignet sich für Entwickler, die Storyboard-Muster, Werbematerialien oder vertikale Kurzvideos in Serie produzieren möchten, und lässt sich über die einheitliche Schnittstelle von HiAPI.ai direkt in Produktionsabläufe einbinden.

Wesentliche Highlights

Prompts beschreiben direkt Bild, Bewegung und Ton – der Prompt trägt visuelle und auditive Beschreibungen zugleich; das Ausgabevideo bringt eine passende Tonspur mit und erspart die nachträgliche Synchronisation.
Prompt-Erweiterung mit dreistufiger Steuerung – prompt_expansion_mode bietet die Stufen disabled, balanced und quality, sodass je nach Bedarf zwischen Bewahrung der ursprünglichen Absicht und mehr Detailreichtum abgewogen werden kann.
Breite Abdeckung von Dauer und Bildformat – die Dauer ist von 0,92 bis 15 Sekunden einstellbar, die Bildformate umfassen sechs Varianten von 21:9 bis 9:16; Querformat-, Quadrat- und Hochformatmaterial lässt sich in einer Konfiguration erzeugen.
Austauschbare Tonspur – über target_audio_url lässt sich die Ausgabe-Tonspur ersetzen; zu langes Audio wird am Anfang abgeschnitten, zu kurzes mit Stille aufgefüllt, was die Abstimmung auf vorgegebene Musik erleichtert.

Funktionsbeschreibung

Parametrisiertes Text-zu-Video: Die Ausgabe wird über die Kombination von prompt, duration, resolution und aspect_ratio gesteuert; Standard ist 768P, 16:9, 5 Sekunden, anpassbar auf 1080P und Hochformat für den jeweiligen Ausspielkanal.

Synchronisierte Audioausgabe: Bei der Videoerzeugung wird zugleich passender Ton erzeugt, ideal für Kurzvideos, die direkt verwendbar sein sollen, und zur Reduzierung nachträglicher Audioarbeit.

Prompt-Erweiterung: Bei knappen Prompts lassen sich die Modi balanced oder quality aktivieren, damit das Modell Details ergänzt; soll die ursprüngliche Beschreibung streng reproduziert werden, auf disabled umschalten.

Tonspur-Austausch und Dauerbeschränkung: Mit target_audio_url kann eigenes Audio eingesetzt werden; bei übergebenem Audio wird die Untergrenze der Dauer auf 2 Sekunden angehoben, um Versatz zwischen zu kurzer Tonspur und Bild zu vermeiden.

Reproduzierbarer Zufalls-Seed: Das Feld seed unterstützt einen festen Zufalls-Seed zur Reproduktion desselben Ergebnisses; eine explizite 0 wird regulär übergeben, was Debugging und Stapelvergleiche erleichtert.

Anwendungsszenarien

Kurzvideo-Teams: Muster aus einer Satz-Storyboard-Beschreibung – Szenentext sowie Dauer- und Formatparameter eingeben und schnell einen Clip mit Ton für Storyboard-Muster und Kundenabstimmung erhalten.
Werbung: Serienproduktion in mehreren Bildformaten – denselben Prompt mit 16:9, 9:16, 1:1 und weiteren Verhältnissen erzeugen und direkt ausspielbares Hoch- und Quadratformat für verschiedene Kanäle produzieren.
Content-Creator: musikgetriebene Fertigstellung – eigenes Audio als target_audio_url übergeben und Bilder erzeugen, deren Länge zur Tonspur passt, für Beat-Sync-Kurzvideos und Musikinhalte.
App-Entwickler: programmatische Video-API-Integration – über die einheitliche Schnittstelle von HiAPI.ai nach Seed und Parametern in Serie aufrufen und Text-zu-Video in Content-Produktion oder Marketing-Automatisierung einbetten.

Einschränkungen und Auswahlhinweise

Die maximale Dauer einer einzelnen Generierung beträgt 15 Sekunden; längere Erzählungen müssen segmentiert und anschließend zusammengesetzt werden. Die Auflösung liegt maximal bei 1080P; für höhere Spezifikationen sollten andere Strecken geprüft werden. Bei aktivierter Prompt-Erweiterung ergänzt das Modell Details; soll die Beschreibung streng wiedergegeben werden, empfiehlt sich das Abschalten. Bei eigenem Audio beträgt die Mindestdauer des Videos 2 Sekunden, und die Tonspur wird gekürzt oder mit Stille aufgefüllt; die Länge des Materials ist selbst zu steuern. Für Szenarien mit ausschließlich Texteingabe sowie für Referenzbild- oder Erst-/Letztbild-Steuerung sollte eine Bild-zu-Video-Strecke derselben Serie gewählt werden.

Neuigkeiten

Changelog ansehen →

Neues Modell Neues Modell: minimax-h3 —— native 2K-Videos über POST /v1/tasks generieren, Unterstützung für 4-15 Sekunden Text-zu-Video… Jul 31, 2026

Häufige Fragen

Alle Fragen ansehen →

Was für ein Videomodell ist MiniMax H3?

Es stellt den Prompt in den Mittelpunkt; optional können Start- und Endbilder oder Referenzbilder, -videos und -audios hinzugefügt werden; die verschiedenen Steuerungsarten sollten gemäß dem aktuellen Parametervertrag kombiniert werden.
Welche Ausgabespezifikationen unterstützt MiniMax H3?

Unterstützt 4-15 Sekunden, Auflösungen einschließlich 2K, Seitenverhältnisse einschließlich 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive.
Können Audiodaten generiert oder Audio-Referenzen verwendet werden?

Optional Bild-, Video- und Audio-Referenzen; Audiogenerierung wird unterstützt
Wie wird MiniMax H3 abgerechnet?

Die Abrechnung erfolgt nach Ausgabedauer und Echtzeit-Stufe; Abweichungen durch Auflösung, Modus oder Tonoptionen richten sich nach dem Seitenpreis und den Aufgabenaufzeichnungen.

Generierungsaufgabe erstellen

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringPflicht

Account-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen

Content-TypestringOptional

Der Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.

Idempotency-KeystringOptional

Idempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.

Idempotenz-Schlüssel

Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.

Body

modelstringPflicht

Aktueller Festwert: minimax-h3-max/text-to-video

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

Geschäftsparameter für minimax-h3-max/text-to-video und Route default — siehe Parametertabelle unten.

seedintegerOptional

Zufälliger Seed zur Steuerung der Zufälligkeit der generierten Ergebnisse. Wird er weggelassen, wählt das System zufällig einen aus; soll der Seed festgelegt werden, muss auch dann explizit 0 übergeben werden, wenn 0 der gewünschte Wert ist.

promptstringPflichtminLength 1maxLength 50000pattern \S

Text-Prompt, der die gewünschte Szene, die Bewegung, die Kameraführung und den Toninhalt beschreibt.

durationnumberOptionalStandard: 5min 0.92max 15

Dauer des generierten Videos, numerischer Wert, Standard 5.

resolutionstringOptionalStandard: "768P"

Auflösung des generierten Videos, Zeichenkette, Standard 768P.

Optionen:480P768P1080P

aspect_ratiostringOptionalStandard: "16:9"

Seitenverhältnis des generierten Videos, Zeichenkette, Standard 16:9.

Optionen:21:916:94:31:13:49:16

target_audio_urlstringOptionalminLength 1pattern ^https?://[^\s/@]+(?:[/?#][^\s]*)?$

Ziel-Audioadresse zum Ersetzen der Tonspur des Ausgabevideos; das Audio muss mindestens 2 Sekunden lang und darf höchstens 15 MB groß sein. Bei längeren Audios wird der Anfang verwendet, bei kürzeren wird mit Stille aufgefüllt.

prompt_expansion_modestringOptionalStandard: "balanced"

Modus zur Prompt-Erweiterung, steuert die automatische Erweiterungsstrategie des eingegebenen Prompts, Standard balanced.

Optionen:disabledbalancedquality

callbackobjectOptional

Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.

Callbacks (Webhook)

Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.

urlstringPflicht

Pflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.

whenstringOptionalStandard: "final"

Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.

Optionen:final

storagestringOptionalStandard: "temp"

Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.

Optionen:temppersistent

Anfragebeispiele

# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-h3-max/text-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "resolution": "768P",
    "aspect_ratio": "16:9",
    "prompt_expansion_mode": "balanced"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "minimax-h3-max/text-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "resolution": "768P",
      "aspect_ratio": "16:9",
      "prompt_expansion_mode": "balanced"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "minimax-h3-max/text-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "resolution": "768P",
          "aspect_ratio": "16:9",
          "prompt_expansion_mode": "balanced"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Aufgabendetails abrufen

GET https://api.hiapi.ai/v1/tasks/:id

Antwortfelder

taskIdstringPflicht

Aufgaben-ID, stets mit Präfix tk-hiapi-.

modelstringPflicht

Aufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.

routestringOptional

Erscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.

statusstringPflicht

Aufgabenstatus.

Statuswerte

queued Eingereiht, noch nicht gestartet. handling In Verarbeitung. archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet. success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben). fail Endzustand: fehlgeschlagen (error wird zurückgegeben). Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.

creatednumberPflicht

Zeitpunkt der Aufgabenerstellung (Unix-Sekunden).

completednumberPflicht

Unix-Sekunden des Endzustands; vor Abschluss stets 0.

outputarrayOptional

Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).

Array [ object ]

Array-Elemente

urlstringPflicht

Artefakt-URL, direkt herunterladbar.

typestringPflicht

Aktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.

expireAtnumberPflicht

Unix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.

errorobjectOptional

Nur bei status == fail.

codestringPflicht

Business-Fehlercode.

messagestringPflicht

Fehlerbeschreibung.

Antwortbeispiele

Erfolg

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In Bearbeitung (nicht final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fehlgeschlagen

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}