MiniMax H3 Max Turbo

MiniMax H3 Max Turbo generiert kurze Videos aus Text oder Frame-Bildern. Nutze die Modell-ID minimax-h3-max-turbo, bewahre die zurückgegebene Aufgaben-ID auf und frage das fertige Video ab. Diese Seite beschreibt die native content-Array-Schnittstelle auf SeedRouter.

Modell-IDs

Aktuelle Preise findest du auf der Modellseite.

Kurzes Beispiel

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max-turbo",
    "content": [
      {"type": "text", "text": "A small sailboat glides across a calm turquoise bay at sunrise, seagulls in the distance, the sound of water and wind. No text, no logos."}
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'

Endpunkt

POST https://api.seedrouter.ai/v1/videos/generations

Die Antwort ist eine Aufgabe ({"id": "task_...", "status": "processing"}), nicht das fertige Video. Frage GET /v1/tasks/{task_id} für das Ergebnis ab. Bewahre API-Schlüssel im serverseitigen Code auf.

Parameter

Das Schema ist strikt: Unbekannte Felder werden abgelehnt statt ignoriert. callback_url ist nicht verfügbar; frage stattdessen die Aufgabe ab. extra ist ein optionales striktes Objekt, das nur prompt_expansion_mode enthält. Alle Felder lehnen null ab; lasse optionale Felder stattdessen weg.

Content-Einträge

Genau ein nicht leerer Texteintrag ist erforderlich. Ein einzelnes Bild ohne Rolle gilt als erster Frame. Höchstens ein erster und ein letzter Frame werden akzeptiert; ein letzter Frame erfordert einen ersten. Referenzbilder, Video und Audio werden nicht unterstützt.

Modi

Die Einträge in content bestimmen den Modus; es wird kein mode-Feld gesendet.

{
  "model": "minimax-h3-max-turbo",
  "content": [
    {"type":"text","text":"Slowly move closer to the ceramic bowl. Keep the glaze and window lighting consistent."},
    {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
    {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
  ],
  "resolution": "480P",
  "duration": 5,
  "ratio": "adaptive",
  "extra": {"prompt_expansion_mode":"balanced"}
}

Frame-Bilder

Nutze öffentliche HTTP(S)-URLs ohne eingebettete Zugangsdaten. Base64 und mm_file://-IDs werden nicht akzeptiert. Bilder dürfen JPG, JPEG, PNG, WebP, HEIC oder HEIF sein, jeweils höchstens 30 MB groß, mit Seiten von 256–5760 Pixeln und Breite/Höhe zwischen 0,4 und 2,5. Die Eingabe wird vor der Generierung geprüft. Nutze bei zwei Frames passende Kompositionen und Seitenverhältnisse.

Inhaltsfilter

content_filter ist true, wenn du keinen Wert setzt. Bei aktiviertem Filter werden Anfrage, Text und Medien vor der Generierung geprüft. Eine beanstandete Anfrage schlägt mit Code 60001 fehl und wird nicht berechnet. Setze content_filter auf false, um die Prüfung zu überspringen; im Playground der Website bleibt sie immer aktiviert.

Preisbestandteile

Der Preisabschnitt des Modells zeigt aktuelle Tarife. Turbo hat einen Kostenbestandteil: Ausgabesekunden in der gewählten Auflösung. Erster und letzter Frame sowie Prompt-Erweiterung haben keinen separaten Preis.

cost = reported output seconds × output-second rate for the resolution

Die Schätzung nutzt die angefragten ganzen Sekunden. Die endgültige Abrechnung nutzt die Ausgabesekundennutzung der abgeschlossenen Aufgabe zum für die Anfrage erfassten Tarif. Ist keine gültige Nutzung verfügbar, gilt die angenommene Schätzung. Die Dauer des Mediencontainers kann leicht von den abgerechneten Sekunden abweichen. Kosten findest du im Nutzungsverlauf deines Kontos; öffentliche Aufgabenantworten enthalten keine Gebühren. Fehlgeschlagene Aufgaben werden nicht berechnet.

Ausgabeschema

Die Übermittlung gibt die Aufgabe zurück:

{"id": "task_...", "model": "minimax-h3-max-turbo", "status": "processing", "created_at": 1789689600}

Aufgabe abrufen

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Frage alle 10–20 Sekunden ab, bis status den Wert completed oder failed hat. Ein Netzwerk-Timeout beim Abfragen bedeutet nicht, dass die Generierung fehlgeschlagen ist: Bewahre die Aufgaben-ID auf und setze die Prüfung fort. Erstelle keine weitere Aufgabe, um den Fortschritt zu prüfen.

Abgeschlossene Aufgabe

{
  "id": "task_...",
  "model": "minimax-h3-max-turbo",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689740,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4",
    "resolution": "768P",
    "ratio": "16:9",
    "duration": 5
  }
}

ratio ist das Seitenverhältnis, in dem der Clip erstellt wurde, einschließlich des für adaptive gewählten Werts. Die Aufgabe enthält die tatsächliche Auflösung, das Seitenverhältnis und die Dauer, soweit gemeldet. Das JSON oben veranschaulicht die Antwortstruktur; es ist kein gemessenes Generierungsergebnis.

Fehler

Anfragen, die vor dem Erstellen einer Aufgabe abgelehnt werden, geben einen HTTP-Fehler mit einem error-Objekt zurück und werden nicht berechnet. Eine nach Annahme fehlgeschlagene Aufgabe gibt beim Abfragen HTTP 200 mit status: "failed" und einem error-Objekt zurück.

Im gemeinsamen Fehlerkatalog findest du Codes, HTTP-Statuswerte und Hinweise zu Wiederholungen.

{
  "id": "task_...",
  "model": "minimax-h3-max-turbo",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

Tritt beim Senden selbst ein Timeout auf, prüfe vor einem erneuten Senden deine Aufgaben: Die erste Anfrage wurde möglicherweise angenommen.

Tipps

• Beschreibe pro Einstellung ein Motiv, eine Handlung, eine Kamerabewegung und eine Lichtgestaltung.
• Nutze 480P für einen Entwurf und 768P für mehr Ausgabedetails. Jede neue Generierung ist eine eigene kostenpflichtige Anfrage.
• Gib einen ersten Frame an, um die Anfangskomposition festzulegen; füge nur dann einen letzten Frame hinzu, wenn du auch den ersten angibst.
• Wähle mit extra.prompt_expansion_mode zwischen disabled, balanced und quality; ohne Angabe bleibt balanced erhalten.
• Prüfe vor der Veröffentlichung den ganzen Clip und sein Audio. Ein Prompt garantiert keine genaue Produktgeometrie oder Beschriftung.

Weiterführendes

• MiniMax H3 Max Turbo Playground und Preise
• OpenAPI herunterladen
• Kopierbares Markdown

Vertragsumfang

Diese Schnittstelle nutzt MiniMax’ content-Array-Anfrageformat mit SeedRouter-Modell-IDs, asynchronen Aufgaben, Bildern ausschließlich als URLs und gehosteten Ergebnissen. Callbacks und Abbruch sind nicht verfügbar. content_filter ist eine SeedRouter-Eingabeprüfung, kein MiniMax-Parameter.

Die separate, bei fal gehostete Schnittstelle hat andere Felder und Grenzen; ihre Einstellungen für 1080P, Bruchteile von Sekunden, Ziellaudio und geordnete Referenzen gelten hier nicht. Seed- und Wasserzeicheneinstellungen werden von dieser Schnittstelle nicht akzeptiert. Die Unterschiede und verlinkten Quellen findest du im Vergleichsleitfaden.