MiniMax ist eine in China verbreitete Plattform für multimodale Modelle. Das Angebot umfasst Text-, Sprach- und Videofunktionen. Viele Teams setzen sie im Kundenservice, bei der Content-Erstellung oder in Sprachdialogsystemen ein.

Dieser Artikel erklärt, wie man die MiniMax API anspricht, welche Zugangswege es gibt und worauf bei der Integration zu achten ist.

Hinweis: MiniMax ist eine Marke ihres jeweiligen Inhabers. Der Artikel bezieht sich auf die im Oktober 2026 üblichen Versionen. Schnittstellen und Preise richten sich nach der offiziellen Dokumentation und den Angaben auf der Website.

1. Typische Funktionen der MiniMax API

  • Textdialog, Texterstellung und Zusammenfassungen.
  • Sprachsynthese und Spracherkennung, je nach Modell.
  • Videogenerierung, je nach Modell.
  • Agent- und Tool-Aufrufe.
  • Multimodale Eingaben.

Die Fähigkeiten unterscheiden sich zwischen den Modellen deutlich. Vor der Integration sollte man deshalb die aktuelle Modellliste und die unterstützten Parameter prüfen, statt von einer einheitlichen Schnittstelle auszugehen.

2. Zugang zum API-Key

Offizielles MiniMax-Konto

Auf der offiziellen Entwicklerplattform registrieren, einen Key anlegen und Guthaben aufladen. Dieser Weg eignet sich für Teams, die die Plattform direkt nutzen können.

ZSQH AI Gateway

  1. Beim ZSQH AI Gateway registrieren.
  2. Einen API-Key anlegen und ein Limit setzen.
  3. Guthaben aufladen.
  4. Modell und Schnittstelle nach der Dokumentation auf der Website auswählen.

Wichtig: Nicht alle MiniMax-Funktionen laufen über das OpenAI-kompatible Protokoll. Textmodelle lassen sich meist über Chat Completions ansprechen; Sprach- und Videofunktionen sind häufig aufgabenbasierte Schnittstellen, die eine eigene Anpassung benötigen.

3. Aufruf eines Textmodells

Wenn das Gateway einen OpenAI-kompatiblen Einstieg bereitstellt:

from openai import OpenAI

client = OpenAI(
    api_key="sk-IHR_KEY",
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="minimax-text",
    messages=[{"role": "user", "content": "Antworte nur mit OK"}],
)
print(resp.choices[0].message.content)

Der Modellname richtet sich nach der Seite Modellpreise. Bei Streaming-Antworten sollte der Client die einzelnen Textabschnitte verarbeiten und nicht auf eine vollständige Antwort warten.

4. Sprach- und Videoschnittstellen

Sprach- und Videoaufgaben sind in der Regel asynchron aufgebaut:

  1. Aufgabe absenden und eine Aufgaben-ID entgegennehmen.
  2. Den Status in festen Abständen abfragen.
  3. Nach erfolgreichem Abschluss das Ergebnis herunterladen.

Diese Schnittstellen unterscheiden sich grundlegend von Chat Completions und lassen sich nicht ohne Weiteres mit einem Chat-SDK aufrufen. Vor dem Einsatz ist zu klären:

  • Ob asynchrone Aufgaben unterstützt werden.
  • Ob Rückrufe oder Polling vorgesehen sind.
  • Welche Grenzen für Dateigröße und Dauer gelten.
  • Wie lange Ergebnisse verfügbar bleiben.

Für die Statusabfrage sollte ein Timeout mit Obergrenze definiert werden. Ohne diese Grenze können Prozesse bei fehlgeschlagenen Aufgaben dauerhaft weiterlaufen.

5. Checkliste für die Integration

  1. Textanfrage und Streaming testen.
  2. Tool-Aufrufe prüfen, sofern unterstützt.
  3. Sprach- oder Videoaufgabe absenden und Status abfragen.
  4. Grenzen für lange Texte und große Dateien testen.
  5. Parallelität und Ratenlimits prüfen.
  6. Abrechnung mit den tatsächlichen Aufrufen abgleichen.

Diese Reihenfolge deckt die meisten Fehlerquellen ab, bevor größere Mengen verarbeitet werden. Besonders der Abgleich der Abrechnung wird häufig zu spät gemacht.

6. Häufige Fehlerbilder

Symptom Ursache Vorgehen
401 Falscher Key oder falsche Adresse Key und Base URL prüfen
404 Falscher Schnittstellenpfad Dokumentation des Anbieters oder Gateways prüfen
Modell nicht verfügbar Modellname oder Berechtigung Preisseite und Freischaltung prüfen
Aufgabe bleibt in Bearbeitung Warteschlange oder zu große Datei Größe reduzieren, später erneut versuchen
429 Ratenlimit erreicht Parallelität senken, Wiederholung einplanen

7. Kosten im Griff behalten

  • Text wird nach Eingabe- und Ausgabe-Token abgerechnet.
  • Sprache wird nach Dauer oder Zeichen abgerechnet.
  • Video wird nach Sekunden, Auflösung oder Aufgabe abgerechnet.
  • Auch fehlgeschlagene Wiederholungsversuche können Kosten verursachen.

Zuerst mit kleinen Mengen testen, dann Preis und Erfolgsquote prüfen und erst danach ausweiten. Bei Videogenerierung ist die Streuung der Kosten besonders hoch, weil Auflösung und Länge stark variieren.

Häufige Fragen

Ist die MiniMax API mit OpenAI kompatibel?

Für den Textbereich gibt es üblicherweise eine kompatible Schnittstelle. Sprach- und Videofunktionen sind meist eigenständige Aufgaben-Schnittstellen; maßgeblich ist die offizielle Dokumentation.

Ist der Zugang aus China stabil?

MiniMax ist eine chinesische Plattform und in der Regel stabiler erreichbar als ausländische Anbieter. Die konkrete Verbindung hängt vom eigenen Netzwerk und der Region ab.

Lassen sich Claude oder GPT gleichzeitig anbinden?

Ja, über ein einheitliches Gateway kann ein Key mehrere Modelle ansprechen. Das Modell wird bei jeder Anfrage angegeben.

Nächster Schritt

Wer einen einheitlichen Einstieg, nutzungsabhängige Abrechnung und Modellwechsel braucht, kann sich beim ZSQH AI Gateway registrieren und zunächst Text- sowie Sprach- oder Videofunktionen mit kleinen Mengen testen. Modelle und Preise stehen auf der Seite Modellpreise.

Weiterlesen: