GLM Coding Plan: Warum trotz Kontingent das Guthaben belastet wird
Standard-, Coding-Plan- und ältere Compatible-Schlüssel unterscheiden, Abrechnung der richtigen Route zuordnen und 429-Fehler gezielt beheben.
Ein GLM-Coding-Plan-Abonnement bedeutet nicht, dass jeder Schlüssel Ihres Kontos das Plankontingent nutzt. Laut Z.ai bestimmt bei Standard- und Coding-Plan-Schlüsseln, die ab dem 16. Oktober 2026 erstellt wurden, der Schlüsseltyp die Abrechnung über unterstützte Endpunkte. Für ältere Compatible-Schlüssel gelten andere, vom Endpunkt abhängige Regeln.
Deshalb können „Ich habe noch Kontingent“ und eine Guthabenbelastung oder ein fehlgeschlagener Aufruf gleichzeitig zutreffen. Dieser Leitfaden enthält ein Prüfblatt für Route und Schlüssel, einen Fehlerklassifikator und ein kontrolliertes Prüfverfahren. Grundlage sind am 17. November 2026 geprüfte offizielle Dokumente. Wir haben keine kostenpflichtigen Abrechnungsexperimente durchgeführt und Ihr Konto nicht eingesehen.
Der Artikel erweitert unsere GLM-Anleitungen. Er kündigt GLM 5.5 nicht an: Der heute geprüfte offizielle öffentliche Index führt weiterhin die GLM-5.3-Familie. Dazu siehe die gesonderte Prüfung von Veröffentlichung und Verfügbarkeit von GLM 5.5. Ersetzen Sie in einer funktionierenden Konfiguration keinen Modellnamen durch eine geratene ID glm-5.5.
Ermitteln Sie die Schlüsselklasse in der Konsole
Nutzen Sie Z.ai’s API Key Management Guide, um den im tatsächlichen Werkzeugprozess konfigurierten Schlüssel zu identifizieren. Prüfen Sie die Kennzeichnung in der Konsole und den Erstellungskontext, nicht das Aussehen der geheimen Zeichenfolge. Ein Konto kann mehrere Schlüsselklassen gleichzeitig enthalten.
| Schlüsselklasse in der Konsole | Herkunft | Zu prüfende Abrechnungsregel |
|---|---|---|
| Standard API Key | Erstellungseintrag für Standard-API-Schlüssel | Kontoguthaben oder anwendbare Nutzungspakete, kein Coding-Plan-Kontingent |
| Personal Coding Plan API Key | Eintrag für persönlichen Coding Plan | Kontingent des Individual Plan |
| Team Plan Key | Team Coding Plan → My Plan | Team-Plan- und Sitzregeln einschließlich konfigurierter Mehrverbrauchsregel |
| Älterer Compatible-Schlüssel | Automatisch klassifizierter älterer Schlüssel | Endpunkt und bisherige Planhistorie des Kontos bestimmen das Verhalten |
Laut Mitteilung vom 16. Oktober müssen vorhandene Schlüsselwerte nicht allein wegen der neuen Klassifizierung ersetzt werden. Ältere Schlüssel eines Team-Plan-Projekts werden Team-Plan-Schlüssel. Berechtigte ältere persönliche Schlüssel von Konten, die jemals einen Coding Plan hatten, werden Compatible-Schlüssel. Für ältere Konten ohne diese Historie gilt die Standard-Klassifizierung. Gesonderte Unternehmens- oder Partnerkanal-Ausnahmen können ihre vertraglichen Regeln behalten.
Tauschen Sie nicht als erste Diagnosemaßnahme alle Schlüssel aus. Ermitteln Sie zunächst, welcher tatsächlich verwendet wird: Ein Terminalexport, eine IDE-Einstellung, Projektkonfiguration oder ein Anbieterwechsel-Werkzeug kann noch auf alte Zugangsdaten verweisen. Notieren Sie nur eine nicht geheime Konsolenbezeichnung oder interne Kennung. Fügen Sie niemals den vollständigen Schlüssel in ein Supportticket oder einen öffentlichen Screenshot ein.
Wenden Sie die richtige Endpunktregel an
Bei neuen Standard- und Coding-Plan-Schlüsseln ändert ein Wechsel zwischen unterstützten Endpunkten nicht den Abrechnungstyp. Ein Standard-Schlüssel in Claude Code kann das API-Guthaben belasten, obwohl ein aktiver Coding Plan noch Kontingent hat. Um Plankontingent zu verbrauchen, verwenden Sie den entsprechenden Planschlüssel mit einer unterstützten Werkzeugkonfiguration.
Für ältere Compatible-Schlüssel beschreibt Z.ai folgendes routenabhängige Verhalten:
| Basis-URL | Protokoll oder Nutzung | Verhalten bei Compatible-Schlüsseln |
|---|---|---|
https://api.z.ai/api/paas/v4 | Standard Chat Completions | Guthaben oder anwendbare Nutzungspakete; kein Coding-Plan-Kontingent |
https://api.z.ai/api/coding/paas/v4 | Coding Plan Chat Completions | Plankontingent, wenn das Konto jemals einen Plan hatte; nach dessen Ablauf stoppen Aufrufe |
https://api.z.ai/api/anthropic | Anthropic Messages | Dieselbe Planhistorienregel aus der offiziellen Compatible-Tabelle |
https://api.z.ai/api/v1 | OpenAI Responses | Dieselbe Planhistorienregel aus der offiziellen Compatible-Tabelle |
Die Mitteilung beschreibt auf den letztgenannten Routen außerdem Guthaben- oder Paketabrechnung für Konten, die noch nie einen Coding Plan hatten. Passt Ihre Konsolenklassifizierung nicht zu diesem Szenario, leiten Sie nichts allein aus der URL ab. Bitten Sie den Support, Schlüsselklassifizierung und Anfrageprotokoll abzugleichen. Team-Mehrverbrauch und gesonderte Unternehmensvereinbarungen erfordern eine kontospezifische Prüfung.
Dies sind Z.ai-Routen. Sie beschreiben weder das Konto des chinesischen BigModel-Dienstes noch die Abrechnung eines Drittanbieters. Ein Ofox-Schlüssel folgt der Ofox-Authentifizierung, nicht Ihrem Z.ai-Abonnement. Prüfen Sie vor einem Wechsel die Ofox-Modellverfügbarkeit und anbieterspezifische Dokumente. Kopieren Sie die Tabellen-URLs nicht in eine Ofox-Konfiguration.
Verfolgen Sie eine Anfrage vom Client bis zum Nutzungsnachweis
Legen Sie vor Änderungen ein kleines Prüfblatt an:
Client and version:
Process actually launched (CLI / IDE / container):
Provider and Base URL:
Protocol (Messages / Chat Completions / Responses):
Exact model ID or alias mapping:
Key class shown in provider console (NO secret value):
Plan active? Remaining quota? Team overage enabled?:
Local timestamp and time zone:
HTTP status / business code / sanitized request ID:
Usage record and billing bucket after the test:
Pausieren Sie unabhängige Testsitzungen, damit sie den Vergleich nicht verfälschen. Erfassen Sie die relevanten Ansichten für Plannutzung und Guthaben. Senden Sie dann nur eine kleine, nicht sensible Anfrage, wenn Sie deren mögliche Kosten freigeben. Fordern Sie beispielsweise vom konfigurierten Modell nur das Wort READY an, ohne Werkzeuge oder Repository-Zugriff. Das prüft einen einfachen Aufruf, nicht die Modellqualität.
Gleichen Sie anschließend Client-Zeitpunkt, verfügbare Anfrage-ID, gewähltes Modell und Nutzungseintrag des Anbieters ab. Eine erfolgreiche Antwort belegt noch nicht, welche Abrechnungsquelle belastet wurde. Berücksichtigen Sie Verzögerungen im Dashboard. Bleibt die Zuordnung unklar, stoppen Sie weitere Versuche und bewahren bereinigte Belege für den Support auf, statt eine Reihe kostenpflichtiger Proben zu erzeugen.
Drei illustrative, nicht gemessene Ergebnisse:
- Ein neuer Standard-Schlüssel in Claude Code funktioniert und erscheint in der Standard-API-Nutzung. Das entspricht der dokumentierten Regel, auch wenn Plankontingent übrig ist.
- Ein älterer Compatible-Schlüssel funktioniert am Standard-Chat-Completions-Endpunkt und belastet das Guthaben. Nur bei diesem älteren Schlüssel kann ein Routenwechsel die Abrechnungsquelle ändern; das lässt sich nicht auf neue Standard-Schlüssel übertragen.
- Ein Compatible-Schlüssel mit abgelaufenem Plan scheitert auf einer Planroute. Laut Mitteilung wechselt er nicht automatisch zur nutzungsabhängigen Abrechnung. Wollen Sie ausdrücklich API-Abrechnung nutzen, erstellen Sie einen Standard-Schlüssel und verwenden ihn an einem unterstützten Endpunkt mit ausreichendem Guthaben. Das ist eine Abrechnungsentscheidung, kein kostenloser Ersatzweg.
Ersetzen Sie bei einem neu erstellten Schlüssel die Zugangsdaten durch die richtige Klasse, starten Sie den tatsächlichen Clientprozess neu und wiederholen Sie eine kontrollierte Prüfung. Entscheiden Sie bei einem Compatible-Schlüssel zunächst zwischen Plan- und Standard-API-Abrechnung und wenden die dokumentierte Regel an. Ändern Sie nicht Schlüssel, Endpunkt, Modell und Wiederholungsstrategie gleichzeitig: Sonst verlieren Sie den Nachweis, welche Änderung das Problem behoben hat.
Lesen Sie den Geschäftscode innerhalb eines 429
Z.ai ordnet in der Fehlercodereferenz mehreren Ursachen HTTP 429 zu. Eine allgemeine Schleife mit exponentieller Wartezeit behebt nicht jede davon.
| Geschäftscode | Dokumentierte Kategorie | Sinnvolle Reaktion |
|---|---|---|
1113 | Unzureichendes Guthaben oder Ressourcenpaket | Abrechnungsquelle und Deckung prüfen; Plankontingent nicht voraussetzen |
1302 | Anfrageratenlimit | Parallelität reduzieren und begrenztes Backoff verwenden |
1305 | Vorübergehende Überlastung | Begrenzt wiederholen; anhaltende Fehler dokumentieren |
1308, 1310 | Nutzungslimits eines Zeitfensters | Zurückgegebene Rücksetzangabe lesen; nicht vom lokalen Mitternachtszeitpunkt ausgehen |
1309 | Coding Plan abgelaufen | Planstatus prüfen; autorisierte Verlängerung oder bewusste Standard-API-Route wählen |
1311 | Plan berechtigt nicht zum gewählten Modell | Modellberechtigung und genaue Zuordnung prüfen |
1313 | Fair-Usage-Einschränkung | Supportverfahren des Anbieters nutzen; zusätzliche Schlüssel sind keine Umgehung |
1315 | Schlüssel auf Unternehmens-Coding-Szenarien beschränkt | Passenden Produktschlüssel und Kontokonfiguration verwenden |
1316–1321 | Nutzungsfenster plus Guthaben- oder Ausgabenbedingung für Mehrverbrauch | Exakte Meldung lesen; Mehrverbrauchsberechtigung und gesetzte Grenzen vor Ausgabenänderungen prüfen |
Authentifizierungsfehler sind ein eigener Zweig: Beispielsweise gehören 1000 und 1001 laut Referenz zu HTTP 401. Mehr Kontingent repariert keinen fehlenden Authentifizierungsheader. Umgekehrt stellt ein wiederholter Austausch eines gültigen Schlüssels keinen abgelaufenen Plan wieder her.
Speichern Sie den folgenden lokalen Klassifikator für gesicherte Fehlerantworten als classify_glm_error.py. Er liest JSON von der Standardeingabe und gibt nur Code und Diagnosekategorie aus, weder Antwortmeldung noch Zugangsdaten.
import json
import sys
categories = {
"1000": "authentication", "1001": "authentication",
"1003": "authentication", "1005": "authentication",
"1113": "billing-balance", "1302": "request-rate",
"1305": "temporary-overload", "1308": "usage-window",
"1309": "plan-expired", "1310": "usage-window",
"1311": "model-entitlement", "1313": "fair-usage",
"1314": "enterprise-plan-expired", "1315": "key-product-mismatch",
}
categories.update({str(n): "extra-usage-condition" for n in range(1316, 1322)})
data = json.load(sys.stdin)
error = data.get("error", {}) if isinstance(data, dict) else {}
code = str(error.get("code", "unknown")) if isinstance(error, dict) else "unknown"
print(json.dumps({"code": code, "category": categories.get(code, "inspect-provider-response")}))
Eine synthetische lokale Prüfung:
printf '%s\n' '{"error":{"code":"1311","message":"synthetic example"}}' | python3 classify_glm_error.py
Die erwartete Kategorie lautet model-entitlement. Wir haben den Klassifikator lokal geprüft, einschließlich numerischer Codes und fehlender Fehlerobjekte. Er diagnostiziert keine Netzwerkfehler, vereinheitlicht keine gatewayspezifischen Antwortformate und ersetzt nicht das Lesen der genauen Anbietermeldung. Ein unbekanntes Ergebnis verlangt die Prüfung der Antwortstruktur und bedeutet nicht, dass die Anfrage erfolgreich war. Bei einem ungewöhnlichen Abbruch eines SSE-Streams dokumentiert Z.ai den Ausnahmegrund in finish_reason statt in diesen gewöhnlichen Fehlercodes. Speichern und prüfen Sie die Streaming-Ereignisse separat; dieser JSON-Klassifikator verarbeitet kein SSE.
Prüfen Sie die Modellwahl nach der Abrechnung
Sobald Schlüssel und Route stimmen, prüfen Sie die genaue Modellzuordnung unabhängig. Der offizielle Leitfaden zum Modellwechsel dokumentiert derzeit GLM-5.3 und GLM-5.3-Flash. Eine Abostufe, ein Clientalias wie Opus und die öffentliche API-ID eines Modells sind unterschiedliche Dinge.
Meldet der Client ein fehlendes Modell, vergleichen Sie ID und Protokoll mit der aktuellen Anbieterdokumentation. Unser OpenAI-Leitfaden zu „model not found“ (Englisch) bietet übertragbare Prüfungen für Anbieter und Endpunkt, um Namensfehler von fehlendem Zugriff zu unterscheiden. Für die allgemeine Anfragetaktung auf Ofox-Routen nutzen Sie die Ofox-Dokumentation zu Ratenlimits. Übertragen Sie diese Grenzen nicht analog auf Z.ai-Konten.
Testen Sie Ihren Plan nicht mit einem spekulativen GLM-5.5-Namen. Beginnen Sie mit einem Modell, das für Konto und Route ausdrücklich verfügbar ist. Erst nach erfolgreichem Basisaufruf und bestätigter Abrechnungszuordnung folgen lange Agentenläufe, Werkzeuge oder Kontexterweiterungen.
Schließen Sie den Vorfall mit Belegen statt einer weiteren Wiederholungsschleife
Ein gelöster Fall benennt Schlüsselklasse, vorgesehenen Endpunkt, akzeptiertes Modell und tatsächliche Abrechnungsquelle und zeigt, dass der relevante Fehler mit der korrigierten Konfiguration nicht mehr auftritt. Bewahren Sie die vorherigen Einstellungen auf, damit Sie Änderungen rückgängig machen können, ohne Geheimnisse neu zu erstellen.
Widersprechen die Anbieterprotokolle der dokumentierten Regel, übermitteln Sie dem Support Zeitpunkt mit Zeitzone, bereinigte Anfrage-ID, Schlüsselklasse, Modell und Fehlercode. Senden Sie weder vollständige Zugangsdaten noch private Prompt-Inhalte ohne gesondert freigegebenen Grund und sicheren Kanal. So wird eine Abrechnungsprüfung möglich, ohne daraus eine weitere unklare Serie von Aufrufen zu machen.
Häufig gestellte Fragen
- Nutzt ein neuer Standard-Schlüssel nach Änderung der Basis-URL das Coding-Plan-Kontingent?
- Nein. Laut Z.ai bestimmt bei ab dem 16. Oktober 2026 erstellten Standard- und Coding-Plan-Schlüsseln der Schlüsseltyp die Abrechnung über unterstützte Endpunkte. Für ältere Compatible-Schlüssel gelten andere Regeln.
- Sollte ich bei jedem GLM-HTTP-429 später erneut versuchen?
- Nein. Der Geschäftscode des Anbieters kann auf Guthaben, Kontingent, einen abgelaufenen Plan, Modellberechtigungen oder Ratenbegrenzung hinweisen. Beheben Sie die genannte Ursache vor dem nächsten Versuch.


