Deine Anwendung kann selbst prüfen, ob noch genug Guthaben da ist und welche Grenzen für den verwendeten Schlüssel gelten. Dafür gibt es zwei Endpunkte: GET /credits für das Guthaben deines Teams und GET /key für den Schlüssel. Beide verursachen keine Kosten und rufen kein Modell auf.
Welcher Schlüssel funktioniert?
Beide Endpunkte funktionieren mit Schlüsseln der Berechtigung KI nutzen und Schlüssel verwalten. Für ein Monitoring-Skript nimmst du am besten einen eigenen Verwaltungsschlüssel. Der kann Guthaben und Verbrauch lesen, aber keine Modelle aufrufen.
Guthaben abfragen: GET /credits
curl https://api.flowmodels.one/v1/credits \
-H "Authorization: Bearer at_dein_schluessel"
{
"object": "credit_balance",
"currency": "EUR",
"billing_mode": "prepaid",
"balance_micro_eur": 20000000,
"reserved_micro_eur": 1000000,
"available_micro_eur": 19000000,
"outstanding_micro_eur": 0,
"postpaid_limit_micro_eur": 0,
"spendable_micro_eur": 19000000,
"reserved_oldest_at": "2026-11-05T08:15:00+00:00"
}
Alle Beträge stehen in Micro-Euro: 1.000.000 Micro-Euro sind 1 €. Im Beispiel liegen also 20 € Guthaben vor, 1 € ist für laufende Aufrufe reserviert, 19 € sind verfügbar.
| Feld | Bedeutung |
|---|---|
balance_micro_eur |
dein Guthaben |
reserved_micro_eur |
für laufende Aufrufe zurückgelegt |
available_micro_eur |
Guthaben abzüglich Reservierungen |
outstanding_micro_eur |
offener, noch nicht bezahlter Verbrauch bei Postpaid |
postpaid_limit_micro_eur |
dein Kreditrahmen, wenn Postpaid freigeschaltet ist |
spendable_micro_eur |
was du insgesamt noch ausgeben kannst, inklusive Kreditrahmen |
billing_mode |
prepaid oder postpaid |
reserved_oldest_at |
Zeitpunkt der ältesten offenen Reservierung oder null |
Für die Frage „Kann meine Anwendung weiterarbeiten?“ ist spendable_micro_eur der richtige Wert. Hängt eine Reservierung sehr lange, also über viele Stunden, ist das ein Klärungsfall für uns. Melde dich dann beim Support.
Dieselben Werte siehst du in der Oberfläche unter Abrechnung im Bereich Guthaben mit Guthaben, Reserviert und Verfügbar.

Aufladen kannst du nur in der Oberfläche, nicht über die Schnittstelle, siehe Guthaben aufladen und automatisch aufladen lassen. Was Prepaid und Postpaid bedeuten, steht in Prepaid oder Postpaid.
Schlüssel prüfen: GET /key
GET /v1/key beschreibt genau den Schlüssel, mit dem du fragst:
name,uuid,kindundstatuscreated_at,last_used_atundexpires_atlimits.spending.monthly_limit_micro_eur: das monatliche Limit des Schlüssels,nullohne eigenes Limitlimits.requests.tierundlimits.requests.per_minute: deine Stufe und die Anfragen je Minute, die für diesen Schlüssel gelten. Hat der Schlüssel ein eigenes, niedrigeres Anfragelimit, steht hier dieser Wert.limits.concurrency.max_concurrent_requests: wie viele Anfragen dein Team gleichzeitig laufen lassen darflimits.payload: die Größengrenzen einer einzelnen Anfrage
Den Schlüsselwert selbst oder andere Schlüssel deines Teams zeigt dieser Aufruf nie.
Statt abzufragen: benachrichtigen lassen
Statt das Guthaben regelmäßig abzufragen, kannst du dich auch informieren lassen. Richte Warnschwellen ein, siehe Ausgabenlimit und Warnschwellen einrichten, und abonniere das Webhook-Ereignis credit.threshold, siehe Webhooks von FlowModels einrichten. Dann meldet sich FlowModels bei deinem Server, sobald eine Schwelle erreicht ist.
Gut zu wissen
- Auch diese Abfragen zählen zu deinem Anfragelimit je Minute. Ein Abruf alle paar Minuten reicht für ein Monitoring völlig.
- Ein monatliches Schlüssellimit wird durch eine Aufladung nicht größer. Ist es erreicht, kommt
429 spend_limit_exceeded, auch wennspendable_micro_eurnoch Guthaben zeigt.