TokenLab Management API fügt Abfrage des Organisationsguthabens hinzu

Die Management API von TokenLab unterstützt jetzt die direkte Abfrage des Guthabens. Damit können Teams den aktuellen Gesamtsaldo ihrer Organisation über ein Management-Token abrufen, anstatt das Dashboard manuell zu überprüfen. Dies schließt eine häufige Lücke für Teams, die automatisierte Budgetprüfungen, Auflade-Benachrichtigungen oder nutzungsabhängige Workflows betreiben.

Wichtige Erkenntnisse

• Die Management API stellt jetzt einen Balance-Endpunkt bereit, der den aktuellen Gesamtsaldo Ihrer Organisation zurückgibt.
• Dies ist getrennt von den API-Schlüsseln für die Modell-Inferenz, die für Aufrufe von Claude Sonnet 5, GPT-5.5, Gemini 3.5 Flash und anderen Modellen verwendet werden.
• Die Guthabenabfrage ist für Budgetprüfungen, Auflade-Benachrichtigungen, das Pausieren oder Fortsetzen automatisierter Workflows sowie zur Speisung von Finanz-Dashboards gedacht.
• Der Endpunkt lässt sich hervorragend mit dem bestehenden Endpunkt für die API-Schlüsselnutzung kombinieren, um ein vollständiges Bild der Ausgaben zu erhalten.

Warum dies fehlte

Vor diesem Update bedeutete die Überprüfung des Organisationsguthabens, sich im TokenLab-Dashboard anzumelden und den Wert auf der Abrechnungsseite abzulesen. Das ist in Ordnung für eine Person, die einmal täglich nachsieht, aber es funktioniert nicht, sobald man etwas automatisieren möchte.

Teams, die Produktions-Workloads mit Modellen wie DeepSeek V4 Pro, Qwen3.7 Plus oder Kimi K2.7 Code betreiben, wünschen sich oft ein Skript, das das Guthaben prüft, bevor ein großer Auftrag gestartet wird, oder einen Monitor, der einen Alarm auslöst, wenn das Guthaben unter einen Schwellenwert fällt. Ohne einen abfragbaren Balance-Endpunkt waren die einzigen Optionen manuelle Prüfungen oder das Scrapen des Dashboards – beides Dinge, die man in der Produktion vermeiden möchte.

Die Guthabenabfrage über die Management API behebt dies. Jetzt kann dieselbe Automatisierung, die eine Reihe von Videogenerierungsaufträgen auf Kling 3.0 oder Seedance auslöst, zuerst das verfügbare Guthaben prüfen und entscheiden, ob fortgefahren werden soll.

Management-Token vs. API-Schlüssel für die Modell-Inferenz

Dies ist eine wichtige Unterscheidung, da die beiden Berechtigungstypen unterschiedliche Zwecke erfüllen und eine Verwechslung zu verwirrenden Fehlern führt.

API-Schlüssel für die Modell-Inferenz werden verwendet, um Modelle direkt aufzurufen. Wenn Sie eine Chat-Completion-Anfrage an GPT-5.5 senden, ein Bild mit GPT Image 2 oder Nano Banana Pro generieren oder ein Video mit Veo 3 oder PixVerse V6 rendern, authentifizieren Sie sich mit einem Inferenz-Schlüssel. Diese Schlüssel sind darauf beschränkt, Modellaufrufe zu tätigen und Modellausgaben zurückzugeben. Sie gewähren keinen Zugriff auf Daten auf Kontoebene wie Guthaben oder Nutzungszusammenfassungen.

Management-Token sind ein separater Berechtigungstyp für Kontovorgänge. Sie ermöglichen es Ihnen, Informationen über Ihre Organisation als Ganzes abzufragen: Guthaben, Nutzung über API-Schlüssel hinweg und andere Daten auf Kontoebene. Ein Management-Token ruft keine Modelle direkt auf. Es ist das Berechtigungsnachweis-Tool für die buchhalterische Seite des Kontobetriebs bei TokenLab, nicht für die Generierungsseite.

Die Trennung ist aus einem praktischen Grund wichtig: Sie können ein Management-Token an einen Finanz- oder Betriebsprozess weitergeben, ohne diesem Prozess gleichzeitig die Möglichkeit zu geben, Ihr Modell-Budget aufzubrauchen. Umgekehrt benötigt ein Dienst, der nur GLM-5.2 oder DeepSeek V4 Flash aufrufen muss, keine Einsicht in Ihr Guthaben oder Ihre Ausgabenhistorie und sollte daher nur über einen Inferenz-Schlüssel verfügen.

So funktioniert die Guthabenabfrage

Der neue Endpunkt gibt den aktuellen Gesamtsaldo Ihrer Organisation als einfache Antwort zurück. Sie rufen ihn mit einem Management-Token auf und erhalten den aktuellen Stand.

Hier ist ein minimales Beispiel mit Platzhalterwerten:

curl -s https://api.tokenlab.sh/v1/management/balance \
  -H "Authorization: Bearer YOUR_MANAGEMENT_TOKEN"

Die Antwort liefert Ihnen den aktuellen Guthabenwert für Ihre Organisation. Das übliche Vorgehen sieht dann so aus:

1. Rufen Sie den Balance-Endpunkt nach einem Zeitplan oder direkt vor Beginn eines kostspieligen Auftrags auf.
2. Vergleichen Sie den zurückgegebenen Wert mit einem von Ihnen definierten Schwellenwert.
3. Lösen Sie die entsprechende Aktion aus: Senden Sie eine Warnung, pausieren Sie eine Warteschlange, blockieren Sie neue Auftragseinreichungen oder protokollieren Sie den Wert für später.

Da es sich um einen einfachen Lesevorgang handelt, ist er kostengünstig und kann häufig aufgerufen werden. Teams, die hochvolumige Pipelines mit Modellen wie DeepSeek V4 Pro oder Claude Sonnet 5 betreiben, können das Guthaben vor jeder großen Charge prüfen, ohne nennenswerten Overhead zu erzeugen.

Vollständige Details zum Endpunkt finden Sie in der Referenz zur Management API Balance.

Wo dies passt: Budgetprüfungen, Warnungen und Dashboards

Die häufigsten Anwendungsfälle, nach denen Teams gefragt haben, lassen sich in vier Szenarien unterteilen:

Anwendungsfall	Beschreibung
Budgetprüfung vor Auftrag	Skript prüft das Guthaben vor dem Einreichen eines großen Batch-Auftrags an ein Modell wie Kling 3.0 oder Veo 3 und überspringt den Auftrag, wenn das Guthaben zu niedrig ist
Auflade-Benachrichtigung	Geplante Prüfung vergleicht das Guthaben mit einem Mindestwert und sendet eine Slack- oder E-Mail-Benachrichtigung, wenn dieser unterschritten wird
Workflow pausieren und fortsetzen	Automatisierung pausiert eine Pipeline, die Qwen3.7 Plus oder GLM-5.2 aufruft, wenn das Guthaben sinkt, und setzt sie nach dem Aufladen fort
Finanz-Dashboards	Guthabenwert wird nach Zeitplan abgerufen und zusammen mit Nutzungsdaten für Berichte angezeigt

Wenn Sie dies zum ersten Mal einrichten, hilft eine kurze Checkliste, die Implementierung sauber zu halten:

• Erstellen oder bestätigen Sie, dass Ihr Management-Token den richtigen Geltungsbereich für den Guthabenzugriff hat
• Speichern Sie das Management-Token getrennt von allen Inferenz-API-Schlüsseln
• Legen Sie ein sinnvolles Abfrageintervall fest (pro Auftrag, stündlich oder täglich, je nach Anwendungsfall)
• Legen Sie Ihren Warnschwellenwert im Voraus fest, nicht erst, wenn das Guthaben zur Neige geht
• Kombinieren Sie die Guthabenabfrage mit dem API-Schlüssel-Nutzungs-Endpunkt, wenn Sie neben dem Guthabenwert eine vollständige Aufschlüsselung der Ausgaben wünschen

Für Teams, die neben dem aktuellen Guthaben auch historische Ausgabendaten wünschen, behandelt der Beitrag zu Dashboard-Nutzungsexporten, wie diese Daten für Berichte abgerufen werden können.

Erste Schritte

Wenn Sie die Management API bereits für Nutzungsberichte verwenden, ist das Hinzufügen von Guthabenprüfungen ein kleiner Schritt: dasselbe Authentifizierungsmuster, ein neuer Endpunkt zum Aufrufen. Wenn Sie noch kein Management-Token eingerichtet haben, generieren Sie eines in Ihren Kontoeinstellungen und halten Sie es getrennt von allen Inferenz-API-Schlüsseln, die Sie für den Aufruf von Modellen verwenden.

FAQ

Erfordert die Guthabenabfrage einen speziellen API-Schlüssel? Nein, es ist kein spezieller Schlüsseltyp über ein Standard-Management-Token hinaus erforderlich. Es handelt sich um einen anderen Berechtigungsnachweis als die Inferenz-API-Schlüssel, die für Modellaufrufe verwendet werden, aber es ist keine zusätzliche Konfiguration erforderlich, außer ein gültiges Management-Token zu besitzen.

Kann ich dies verwenden, um Aufträge automatisch zu stoppen, wenn das Guthaben aufgebraucht ist? Ja. Das ist einer der primären Anwendungsfälle. Prüfen Sie das Guthaben vor oder während eines Auftrags, und wenn es unter Ihren Schwellenwert fällt, pausieren Sie den Workflow, halten Sie die Warteschlange an oder blockieren Sie neue Einreichungen, bis das Guthaben wiederhergestellt ist.

Ist dies dasselbe wie der Nutzungs-Endpunkt? Nein. Die Guthabenabfrage gibt Ihren aktuellen Gesamtsaldo zurück. Der API-Schlüssel-Nutzungs-Endpunkt gibt Nutzungsdaten zurück, die nach Schlüssel aufgeschlüsselt sind. Die meisten Finanz-Dashboards verwenden beides zusammen.

Quellen und Aktualität

Dieser Artikel spiegelt den Balance-Endpunkt der Management API mit Stand vom 07.07.2026 wider. Das Verhalten des Endpunkts und die Antwortformate können sich ändern; prüfen Sie die offizielle Dokumentation zum Balance-Endpunkt für die aktuelle Referenz.

---

Sind Sie bereit, Guthabenprüfungen in Ihren Workflow zu integrieren? Melden Sie sich bei TokenLab an, generieren Sie ein Management-Token und beginnen Sie noch heute mit der Abfrage Ihres Organisationsguthabens.

Weiterführende Lektüre und nächste Schritte

Die Abfrage des Organisationsguthabens funktioniert zusammen mit anderen Reporting-Tools, die bereits in der TokenLab Management API verfügbar sind. Einen genaueren Blick darauf, wie Ausgabendaten regelmäßig abgerufen und überprüft werden können, finden Sie unter TokenLab Usage Exports Make AI API Spend Easier to Review. Wenn Sie Ausgaben vor einem Start planen, führt Sie der AI API Cost Calculator Guide: Estimate Spend Before You Ship durch die Kostenschätzung, bevor Anfragen gesendet werden. Und für den Kontext, wie Anbieter im Vergleich zueinander abschneiden, analysiert der AI API Pricing Comparison 2026: The Real Cost of GPT-5.5, Claude Sonnet 5, and Gemini 3.5 Flash die aktuellen Raten der wichtigsten Modelle.

Wie immer ändern sich Modellverfügbarkeit und Preise häufig, daher sollten Sie aktuelle Details bestätigen, bevor Sie sich für den hochvolumigen Produktionseinsatz darauf verlassen. Bereit, die Guthabenabfrage selbst auszuprobieren? Erstellen Sie einen API-Schlüssel und beginnen Sie noch heute mit dem Testen.