FlowModels

Guthaben und Schlüsselgrenzen per API abfragen: GET /credits und GET /key

Veröffentlicht am 11. November 2026

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.

Die Abrechnung 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, kind und status
  • created_at, last_used_at und expires_at
  • limits.spending.monthly_limit_micro_eur: das monatliche Limit des Schlüssels, null ohne eigenes Limit
  • limits.requests.tier und limits.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 darf
  • limits.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 wenn spendable_micro_eur noch Guthaben zeigt.

War dieser Artikel hilfreich?

Zurück zu Guthaben & Abrechnung