MiniMax M Plan- oder Token Plan-Kontingent aufgebraucht: Zeitfenster prüfen und weiterprogrammieren

Wenn ein mit MiniMax verbundenes Coding-Tool plötzlich stoppt, solltest du nicht wahllos Clients oder Schlüssel wechseln. Kläre zuerst, ob ein M Plan-Nutzungsfenster ausgeschöpft ist, ein temporäres Rate Limit greift, das Konto noch einen beibehaltenen Token Plan nutzt oder der falsche Schlüsseltyp konfiguriert wurde. Erst dann entscheidest du zwischen Warten, passenden Credits oder einem unabhängigen Pay-as-you-go-API-Pfad für die verbleibende Text-Coding-Aufgabe.

Starte mit dieser Entscheidungstabelle

Was du siehst	Was du zuerst prüfst	Sinnvoller erster Schritt
In der Konsole ist das 5-Stunden- oder Wochenfenster leer	Planname und Endzeit beider Fenster	Auf den passenden Reset warten oder prüfen, ob Credits die Funktion abdecken
Kontingent ist noch vorhanden, aber nach vielen Anfragen werden Aufrufe blockiert	Anfragefrequenz, Parallelität und dynamische Drosselung zu Spitzenzeiten	Frequenz oder Parallelität senken und später erneut versuchen
Das Konto zeigt weiterhin Token Plan	Ob es sich um ein beibehaltenes Abo handelt und ob bereits ein Upgrade erfolgte	Den Hinweisen für den Altplan folgen und nicht alle M Plan-Regeln übertragen
Nach einem Schlüsselwechsel wird Kontoguthaben belastet	Subscription Key oder Pay-as-you-go-API-Key	Schlüssel nicht mischen und den gewünschten Abrechnungspfad korrekt einrichten
Text-Coding muss sofort weitergehen	Ob getrennte Abrechnung akzeptabel ist und keine M Plan-exklusive Funktion benötigt wird	Unabhängigen Provider mit eigenem Schlüssel, Endpoint und Model ID konfigurieren

Ähnliche Meldungen im Client können unterschiedliche Ursachen haben. Die sichere Reihenfolge lautet: zuerst Plan und Fenster, danach Schlüsseltyp und erst zuletzt Providerwechsel.

M Plan hat unabhängige 5-Stunden- und 7-Tage-Fenster

Die offiziellen M Plan usage rules beschreiben zwei automatisch zurückgesetzte Nutzungsfenster:

• Text-, Bild-, Audio- und andere Nicht-Video-Modelle benötigen Restkontingent sowohl im 5-Stunden-Fenster als auch im 7-tägigen Wochenfenster.
• Videomodelle unterliegen nur dem Wochenfenster.
• Beide Fenster beginnen mit der ersten Nutzung. Nach Ablauf wird das vollständige Limit der jeweiligen Stufe wiederhergestellt; die nächste Nutzung startet ein neues Fenster.
• Die Fenster werden unabhängig zurückgesetzt. Ein 5-Stunden-Reset setzt die Wochennutzung nicht zurück.
• Nicht verwendetes Kontingent sammelt sich nicht an und wird nicht in den nächsten Abrechnungszeitraum übertragen.

Deshalb kann auch nach fünf Stunden noch kein Zugriff möglich sein: Das Wochenfenster kann weiterhin ausgeschöpft sein. Umgekehrt kann Restkontingent vorhanden sein, während ein temporäres Rate Limit die Aufrufe blockiert.

Alle unterstützten Tools teilen sich dieselbe M Plan-Nutzung

M Plan vergibt kein separates Kontingent pro Client. Die Nutzung in MiniMax Code und in unterstützten Tools, die über denselben Subscription Key verbunden sind, zählt gegen dieselben Planlimits.

Ein Wechsel von Claude Code zu OpenCode, eine neue Sitzung oder derselbe Subscription Key in einem anderen Tool erzeugt daher kein neues Kontingent. Auf der MiniMax-Nutzungsseite findest du Plan, Fenster, Credits und Verlauf. Mit MiniMax CLI kannst du außerdem ausführen:

mmx quota

Der Befehl zeigt M Plan-Nutzung und verbleibendes Kontingent. Das ist zuverlässiger, als aus einer allgemeinen Client-Fehlermeldung auf die Ursache zu schließen.

Ein Rate Limit ist kein ausgeschöpftes Nutzungsfenster

MiniMax behandelt Nutzungsgrenzen und Anfrageraten als getrennte Kontrollen. Viele Anfragen in kurzer Zeit, hohe Parallelität oder dynamische Begrenzungen zu Spitzenzeiten können Aufrufe vorübergehend blockieren, obwohl noch Kontingent vorhanden ist.

Senke Anfragefrequenz und Parallelität und versuche es später erneut. Kaufe nicht allein wegen einer kurzen Drosselung Credits, führe kein Upgrade durch und tausche keine Schlüssel. In den Pfad „Kontingent ausgeschöpft“ wechselst du erst, wenn die Konsole tatsächlich ein leeres 5-Stunden- oder Wochenfenster zeigt.

Prüfe, ob das Konto M Plan oder einen beibehaltenen Token Plan nutzt

Nach Einführung von M Plan wurde Token Plan nicht mehr für neue Käufe angeboten. Bestehende Abonnenten konnten ihren Plan behalten oder auf M Plan wechseln. Deshalb ist die Anzeige im Konto entscheidend:

• Zeigt Plan Details M Plan, gelten die Regeln für unabhängige Fenster, gemeinsame Nutzung und Credits.
• Zeigt die Seite weiterhin Token Plan, lies Existing Token Plan subscribers und prüfe den Status des beibehaltenen Abos sowie der automatischen Verlängerung.
• Das Upgrade ist nicht rückgängig zu machen: Laut offizieller Mitteilung ist keine Rückkehr zu Token Plan möglich; danach bestimmen Modelle, Limits, Vorteile und Verlängerung der neuen M Plan-Stufe die Nutzung.

Leite die aktuellen Regeln nicht aus einem alten Beitrag oder einer gespeicherten Konfiguration ab. Prüfe zuerst den tatsächlichen Namen und Status unter Plan Details.

Wenn das Kontingent wirklich aufgebraucht ist, entscheide nach Abhängigkeit

1. Du brauchst Abo-exklusive Funktionen: Warte auf den richtigen Reset

Warten ist die sauberste Lösung, wenn die Aufgabe von einem M Plan-exklusiven Modell, MiniMax Code-Vorteilen oder demselben Subscription-Key-Pfad abhängt. Prüfe, ob das 5-Stunden-Fenster, das Wochenfenster oder beide ausgeschöpft sind, und orientiere dich an der Endzeit in der Konsole.

Währenddessen kannst du unnötige Dateien aus dem Kontext entfernen, eine fokussierte Sitzung vorbereiten und große Aufgaben in prüfbare Schritte teilen. Das zieht den Reset nicht vor, senkt aber möglicherweise den Verbrauch im nächsten Fenster.

2. Das Konto hat Credits: Prüfe die Eignung

Zuerst wird das im M Plan enthaltene Kontingent verbraucht. Danach können vorhandene Credits geeigneten Mehrverbrauch abdecken, doch Credit-Pakete gelten nur für die jeweils unterstützten Modelle und Funktionen.

Prüfe auf der Nutzungsseite Guthaben, Ablaufdatum und unterstützte Fähigkeit. Vorhandene Credits bedeuten nicht automatisch, dass jede Operation weiterlaufen kann.

3. Text-Coding muss sofort weitergehen: Nutze einen getrennten Pay-as-you-go-Pfad

Wenn die Aufgabe keine exklusiven M Plan-Vorteile benötigt, kann ein unabhängiger API-Provider den Text-Workflow fortsetzen. Er hat einen eigenen Schlüssel und eine eigene Abrechnung. Dieser Pfad setzt M Plan nicht zurück, überträgt keine Credits und verschiebt keine MiniMax Code-Vorteile.

MiniMax trennt bereits den standardmäßigen Pay-as-you-go-API-Key vom Subscription Key; beide sind nicht austauschbar. Halte dieselbe Grenze bei externen Providern ein: Jede Konfiguration verwendet nur dessen eigenen Schlüssel, Base URL und exakte Model ID.

Beispiel: ein unabhängiger OpenCode-Pfad über BetterToken

BetterToken ist hier ein optionales Beispiel für einen getrennten Provider, kein Nachfüllen des M Plan-Kontingents. Am 10. Oktober 2026 führt der aktuelle BetterToken-Modellkatalog die exakte ID MiniMax-M3; die OpenCode-Anleitung verwendet die OpenAI-kompatible Base URL https://www.bettertoken.ai/v1.

Laut MiniMax-Modelldokumentation ist MiniMax-M3.1-Flash-Preview derzeit nur über M Plan und MiniMax Code verfügbar. Übernimm diese Preview-ID nicht in eine externe Providerkonfiguration, sondern nutze die exakte ID aus dessen aktuellem Katalog.

Einrichtung ohne gemischte Schlüssel

1. Erstelle in deinem BetterToken-Konto einen BetterToken API Key. Verwende keinen MiniMax Subscription Key.
2. Führe in OpenCode /connect aus, wähle Other, setze die provider id auf bettertoken und gib den BetterToken-Schlüssel in der Anmeldeabfrage ein.
3. Erstelle opencode.json im Projektverzeichnis oder aktualisiere ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "bettertoken/MiniMax-M3",
  "provider": {
    "bettertoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BetterToken",
      "options": {
        "baseURL": "https://www.bettertoken.ai/v1"
      },
      "models": {
        "MiniMax-M3": {
          "name": "MiniMax-M3"
        }
      }
    }
  }
}

4. Starte OpenCode neu, wähle bettertoken/MiniMax-M3 und sende eine kurze Coding-Frage.
5. Eine normale Antwort bestätigt die Konfiguration des separaten API-Pfads. Sie bedeutet nicht, dass das MiniMax-Abo-Kontingent zurückgesetzt oder übertragen wurde.

Die vollständige Einrichtung steht in der BetterToken-OpenCode-Anleitung. Prüfe die ID vor dem Speichern im aktuellen Modellkatalog.

Wenn der unabhängige Pfad fehlschlägt, prüfe Schicht für Schicht

• Authentifizierungsfehler: Führe /connect erneut aus und stelle sicher, dass du einen BetterToken-Schlüssel statt eines MiniMax Subscription Key eingegeben hast.
• Endpoint-Fehler: Verwende exakt https://www.bettertoken.ai/v1 als Base URL und hänge nicht /chat/completions an.
• Modell nicht gefunden: Prüfe Groß-/Kleinschreibung und vollständige ID. Verwende MiniMax-M3 beziehungsweise bettertoken/MiniMax-M3 in den passenden Feldern.
• Konfiguration unverändert: Starte OpenCode neu und prüfe, ob eine projektbezogene opencode.json die globale Datei überschreibt.
• Das ursprüngliche MiniMax-Tool bleibt blockiert: Das ist die erwartete Grenze. Ein separater Provider ändert weder Fenster noch Credits noch den MiniMax-Abostatus.

Fünf häufige Zeitfresser

1. Eine temporäre Drosselung als verbrauchtes Kontingent behandeln. Wenn noch Kontingent vorhanden ist, Parallelität senken und erneut versuchen.
2. Nur auf den 5-Stunden-Reset warten. Nicht-Video-Modelle brauchen auch Restkontingent im Wochenfenster.
3. Denselben Subscription Key zwischen Tools verschieben. Unterstützte Tools teilen dieselbe M Plan-Nutzung.
4. Subscription Key und Pay-as-you-go-API-Key mischen. Sie nutzen unterschiedliche Rechte und Abrechnungspfade.
5. MiniMax-M3.1-Flash-Preview als universelle externe Model ID ansehen. Externe Tools benötigen die exakte ID ihres aktuellen Providerkatalogs.

Die praktische Reihenfolge

Prüfe Plan und verbleibende Fenster in der Konsole oder mit mmx quota. Ist es nur ein Rate Limit, senke Frequenz und Parallelität. Ist das Kontingent aufgebraucht, warte bei Abo-exklusiven Anforderungen, nutze Credits nur für geeignete Aufgaben oder richte einen getrennten Pay-as-you-go-Provider ein, wenn Text-Coding ohne Unterbrechung wichtiger ist.

Versuche nicht, das Problem durch zufälliges Wechseln von Schlüsseln zu lösen. Eine klare Trennung zwischen M Plan oder beibehaltenem Token Plan, Subscription Key, standardmäßigem Pay-as-you-go-Key und externem Provider-Schlüssel verhindert Fehldiagnosen und Belastungen des falschen Kontos.