MiniMax API-Schlüssel stammen meist aus zwei Quellen: der offenen MiniMax-Plattform und einem kompatiblen Einstieg wie dem ZSQH AI Gateway. Beide können Modelle aufrufen, doch Registrierung, Geltungsbereich der Schlüssel und Abrechnung sind getrennt. Dieser Beitrag folgt der praktischen Reihenfolge: registrieren, erstellen, speichern, Rechte isolieren, rotieren und 401 analysieren; am Ende steht eine Empfehlung zur Wahl zwischen offiziellem und Gateway-Schlüssel.

Für Teams bei der ersten Integration gilt ein Merksatz: Ein Schlüssel sollte nicht möglichst allmächtig sein, sondern nach Umgebung, Person und Zweck getrennt, sperrbar, nachverfolgbar und austauschbar. So gefährdet ein einzelner Schlüssel nicht das gesamte Geschäft.

Hinweis: MiniMax ist eine Marke des jeweiligen Inhabers; dieser Beitrag dient der technischen Erläuterung. Plattformzugänge, Schlüsselverwaltung und Limits richten sich nach offizieller MiniMax-Dokumentation und Konsole; Modelle und Abrechnung nach der Preisübersicht.

1. Zuerst drei Schlüsseltypen unterscheiden

Bei MiniMax gibt es derzeit zwei übliche offizielle Schlüsselarten: den Schnittstellenschlüssel für nutzungsabhängige Abrechnung und den Abonnementschlüssel für M Plan. Ersterer wird auf der Seite „Schnittstellenschlüssel“ des Kontos erstellt und unterstützt Sprach-, Video-, Sprach- und Bildmodelle; letzterer ist auf der Abonnement- und Abrechnungsseite zu finden und gilt für das M-Plan-Abonnement sowie gekaufte Credits. Die dritte Art ist der Schlüssel des ZSQH AI Gateway, der nur innerhalb des Gateways für die einheitliche Nutzung freigeschalteter Modelle gilt.

Die drei Typen nicht vermischen. Der häufigste Unfall: Ein offizieller Schlüssel wird in die Gateway-Adresse eingetragen oder ein Gateway-Schlüssel an die offizielle Schnittstelle gesendet; anschließend wird lange im Code gesucht, bis sich herausstellt, dass nur Adresse und Schlüssel nicht zusammenpassen.

Schlüsseltyp Ort der Erstellung oder Ansicht Geltungsbereich Geeignetes Szenario
Offizieller nutzungsabhängiger Schlüssel Offene Plattform, „Schnittstellenschlüssel“ Freigeschaltete Modelle und Schnittstellen des offiziellen Kontos Ausschließlich MiniMax, direkte Abrechnung mit dem Anbieter
Offizieller M-Plan-Abonnementschlüssel Abonnement- und Abrechnungsseite M-Plan-Abonnement und gekaufte Credits Abonnement erworben, Nutzung nach Paket
Gateway-Schlüssel ZSQH-Konsole Im Gateway freigeschaltete Modelle Einheitlicher Multi-Modell-Einstieg und einheitliche Abrechnung

2. Registrierung: zuerst chinesische oder internationale Seite klären

MiniMax betreibt zwei Zugänge: platform.minimax.cn und platform.minimax.io. Zugang, Konsole und Base URL unterscheiden sich; vor der Registrierung muss klar sein, welche Seite das Team erreicht und welche Abrechnung passt. Nicht auf der chinesischen Seite registrieren und den Schlüssel dann an der internationalen Adresse verwenden.

Für Teams empfiehlt sich „Hauptkonto plus Unterkonto“. Laut Dokumentation der chinesischen Seite kann das Hauptkonto Unterkonten anlegen; diese teilen Rechte, Rate-Limits, API-Verbrauch und Abrechnung des Hauptkontos, dürfen aber Zahlungen nicht einsehen oder verwalten. So hat jede Person eine eigene Anmeldeidentität, und beim Austritt wird das Unterkonto deaktiviert, statt Hauptkonto-Passwörter weiterzugeben.

Verlangt die Konsole zusätzliche Unternehmensangaben oder Prüfschritte, nach den Seitenhinweisen vorgehen; maßgeblich ist der Ablauf bei der Registrierung.

3. Schritte zum Erstellen eines Schlüssels

  1. Bei der offenen MiniMax-Plattform anmelden und im Benutzerzentrum die Seite „Schnittstellenschlüssel“ öffnen. Der Pfad der chinesischen Seite lautet platform.minimax.cn/user-center/basic-information/interface-key.
  2. Auf Neu erstellen klicken und den Namen eindeutig nach Zweck benennen, etwa prod-kundenservice oder test-zhang.
  3. Den angebotenen Geltungsbereich gemäß Seitenhinweis wählen oder bestätigen. Bietet die Seite keine modellgenauen Rechte, gilt derzeit die Kontoberechtigung.
  4. Den Schlüssel nach der Erstellung sofort kopieren und in einem Passwortmanager oder Schlüsseldienst speichern. Nicht als Screenshot in Gruppen posten und nicht als Codekommentar ablegen.
  5. Bei Nutzung von M Plan den Abonnementschlüssel nicht auf der Seite für Schnittstellenschlüssel, sondern auf der Abonnement- und Abrechnungsseite suchen.
  6. Mit einer minimalen Anfrage prüfen, ob der Schlüssel funktioniert und Region, Base URL sowie Modellname zusammenpassen.
  7. Im Teamregister Verantwortlichen, Zweck, Erstellungsdatum und Sperrbedingungen festhalten.

Zu Schritt 3 ist wichtig: Die öffentliche Dokumentation beschreibt keine allgemeine modellgenaue Schlüsselberechtigung; maßgeblich ist die Konsole. Wer Geschäftsbereiche isolieren will, nutzt bevorzugt Unterkonten oder getrennte Schlüssel je Umgebung und verlässt sich nicht auf einen Schlüssel für alles.

4. Rechteisolierung: eine Umgebung, ein Schlüssel

Mindestens drei Kategorien trennen: Entwicklung, Vorabumgebung und Produktion. Produktionsschlüssel gehören ausschließlich in serverseitige Umgebungsvariablen oder einen Schlüsseldienst, nicht in Browser, mobile Apps oder Desktop-Clients. Testschlüssel erhalten ein niedrigeres Limit und lassen sich jederzeit sperren.

Bei mehreren Geschäftslinien zusätzlich nach Geschäft trennen: Kundenservice, Content-Erstellung und Batch-Verarbeitung erhalten jeweils einen eigenen Schlüssel. So lässt sich eine auffällige Linie einzeln abschalten, ohne andere zu beeinträchtigen; auch die Verbrauchsanalyse wird leichter.

Ziel der Rechteisolierung ist nicht zusätzliche Bürokratie, sondern eine klare Fehlergrenze. Ein Schlüssel für alle Geschäftsbereiche spart kurzfristig Aufwand und erschwert langfristig die Analyse.

5. Schlüssel in Umgebungsvariablen ablegen

Schlüssel nicht im Code ablegen. Das folgende Minimalbeispiel ist für lokale .env-Dateien gedacht; in der Produktion einen Schlüsseldienst der Plattform oder Container-Secrets verwenden.

# .env (nicht in Git einchecken)
MINIMAX_API_KEY=Ihr-Schluessel
# Beispiel für die offizielle chinesische Seite; beim Gateway Adresse und Modellnamen ersetzen
MINIMAX_BASE_URL=https://api.minimax.cn/v1
MINIMAX_MODEL=MiniMax-M3.1-Flash

# .gitignore
.env
.env.*

In Python den Wert über os.environ["MINIMAX_API_KEY"] lesen und den Schlüssel nicht als Standardwert in Funktionsparameter schreiben. Drei Punkte beachten: .env muss in .gitignore stehen; Container und CI dürfen den Schlüssel nicht in Image-Schichten einbacken; beim Loggen von Request-Headern zuerst anonymisieren, damit Authorization nicht im Log landet.

Bei einem Schlüsseldienst der Anwendung nur Leserechte geben und jeden Abruf protokollieren. Den Schlüssel nicht in Chatwerkzeuge oder Dokumenttexte kopieren.

6. Rotation und Umgang mit einer Offenlegung

Die offizielle Dokumentation nennt keinen festen Rotationszyklus; die Frequenz sollte nach Risiko gewählt werden. Für zentrale Produktionsschlüssel sind 90 Tage üblich; bei Personalwechsel, Geräteverlust oder vermuteter Offenlegung sofort rotieren.

Die Reihenfolge lautet: neu erstellen, umstellen, alt sperren.

  • Neuen Schlüssel anlegen und mit Datum benennen, etwa prod-2026-10.
  • Neuen Schlüssel im Schlüsseldienst hinterlegen und zuerst in der Vorabumgebung prüfen.
  • Produktionsverkehr grau umschalten und Fehlerquote sowie Verbrauch beobachten.
  • Nach Stabilisierung den alten Schlüssel sperren und die Aktion dokumentieren.
  • Prüfen, ob der alte Schlüssel vor der Sperrung ungewöhnliche Aufrufe hatte.

Bei Verdacht auf Offenlegung nicht nur die Zeichenkette im Code ändern. Den Schlüssel sofort in der Konsole sperren oder löschen, einen neuen erstellen, Rechnung und Aufruflogs prüfen und bei Bedarf den Plattformsupport kontaktieren. Die offizielle Dokumentation erwähnt, dass öffentlich offengelegte Schlüssel automatisch gesperrt werden können; darauf sollte man sich nicht als einzige Absicherung verlassen.

7. 401 analysieren: zuerst Adresse, dann Schlüssel

401 bedeutet fehlgeschlagene Authentifizierung und nicht automatisch fehlendes Guthaben oder Rate-Limit. Prüfen Sie in dieser Reihenfolge:

  • Lautet der Header Authorization: Bearer <Key> mit genau einem Leerzeichen zwischen Bearer und Schlüssel?
  • Wurde der Schlüssel vollständig kopiert, ohne Leerzeichen, Zeilenumbruch oder Anführungszeichen davor oder danach?
  • Ist der Schlüssel der chinesischen Seite mit der chinesischen Adresse verbunden, der internationale mit der internationalen?
  • Wurde ein offizieller Schlüssel versehentlich in die Gateway-Adresse eingetragen oder ein Gateway-Schlüssel in die offizielle Adresse?
  • Wurde der Schlüssel gelöscht, gesperrt oder gehört er zu einem abgelaufenen Abonnement?
  • Wurde die Umgebungsvariable tatsächlich geladen? Im Container den Variablennamen ausgeben, nicht den Wert.

403 deutet meist auf Rechte oder Kontingent hin, 429 auf ein Rate-Limit; erst Meldungen wie insufficient balance weisen auf das Guthaben. 401 und diese Fehler getrennt behandeln.

8. Offizieller Schlüssel oder Gateway-Schlüssel

Wer ausschließlich MiniMax nutzt, Registrierung und Abrechnung direkt erledigen kann und die Schlüssel verschiedener Anbieter selbst verwalten will, fährt mit der offiziellen Direktverbindung einfacher. Wer MiniMax, Claude, GPT, DeepSeek und weitere Modelle gleichzeitig anbinden oder einen Schlüssel, eine Abrechnung und eine einheitliche Verbrauchsansicht wünscht, spart mit einem Gateway Aufwand.

Der Preis des Gateways ist eine zusätzliche Abhängigkeit. Deshalb drei Punkte klären: welche MiniMax-Modelle unterstützt werden, ob die Abrechnungslogik klar ist und welche Supportkanäle bei Problemen bestehen. Zuerst klein testen, dann Produktionsverkehr senden. Modelle und Abrechnung stehen in der Preisübersicht; ein Testschlüssel lässt sich über die Registrierung anlegen.

Häufige Fragen

Wo wird der MiniMax API Key erstellt?

Der offizielle nutzungsabhängige Schlüssel wird im Benutzerzentrum der offenen Plattform auf der Seite „Schnittstellenschlüssel“ erstellt; der M-Plan-Abonnementschlüssel steht auf der Abonnement- und Abrechnungsseite. Der genaue Pfad richtet sich nach der Konsole der jeweiligen Seite.

Kann ein Schlüssel Text, Sprache und Video gleichzeitig aufrufen?

Der offizielle nutzungsabhängige Schnittstellenschlüssel unterstützt Sprach-, Video-, Sprach- und Bildmodelle. Ob er nutzbar ist, hängt jedoch von Kontorechten, Modellfreischaltung und Schnittstellentyp ab. Sprache und Video laufen meist über asynchrone Aufgaben-Endpunkte und lassen sich nicht direkt mit dem Chat-Endpunkt aufrufen.

Darf der Schlüssel im Frontend oder in einer Mini-App liegen?

Nein. Frontend-Code, Browseranfragen und Mini-App-Pakete lassen sich dekompilieren oder abfangen. Der Schlüssel gehört ausschließlich auf den Server, der die Anfragen weiterleitet. Muss direkt zugegriffen werden, sind kurzlebige Token oder eingeschränkte Rechte nötig, und das Risiko einer Offenlegung ist zu akzeptieren.

Erfordert die Rotation eine Ausfallzeit?

Nein. Zuerst einen neuen Schlüssel erstellen, in der Vorabumgebung prüfen, dann Produktionsverkehr grau umstellen und zuletzt den alten Schlüssel sperren. Entscheidend ist eine Phase, in der alter und neuer Schlüssel parallel bestehen, damit nicht im Umschaltmoment alles ausfällt.

Lassen sich offizieller Schlüssel und Gateway-Schlüssel mischen?

Nein. Beide gelten nur auf ihrer jeweiligen Plattform und Adresse. Eine Vermischung äußert sich meist als 401 oder 404; zuerst prüfen, ob Base URL und Schlüssel von derselben Plattform stammen.

Nächster Schritt

Klären Sie zuerst, ob nur MiniMax oder ein einheitlicher Multi-Modell-Einstieg benötigt wird. Für ein Modell genügt ein Schlüssel nach offizieller Dokumentation. Für einen einheitlichen Einstieg lässt sich das ZSQH AI Gateway registrieren, ein Testschlüssel anlegen und die Modelle sowie Abrechnung in der Preisübersicht prüfen. In beiden Fällen den Schlüssel in Umgebungsvariablen ablegen und Test sowie Produktion trennen.

Weiterlesen: