Unter Verbrauch und Anfragen siehst du in der Oberfläche, was deine Anwendungen verbraucht haben. Willst du diese Zahlen in dein eigenes Reporting, deine Buchhaltung oder ein Dashboard holen, nutzt du die beiden Endpunkte GET /usage und GET /usage/requests. Typischer Fall: Du gibst die Kosten je Kunde an deine eigenen Kunden weiter.
Zusammenfassung: GET /usage
GET /v1/usage fasst Anfragen, Tokens und Kosten eines Zeitraums zusammen.
curl "https://api.flowmodels.one/v1/usage?start=2026-10-01&end=2026-10-31&group_by=end_user" \
-H "Authorization: Bearer at_dein_schluessel"
startundendsind Tage im FormatJJJJ-MM-TT. Ohne Angabe bekommst du die letzten 30 Tage bis heute.group_bybestimmt die Aufteilung:day(Standard),model,api_keyoderend_user.
{
"object": "list",
"data": [
{"bucket": "kunde-1042", "requests": 128, "prompt_tokens": 61240, "completion_tokens": 18410, "total_tokens": 79650, "cost_micro_eur": 1840000}
],
"start": "2026-10-01",
"end": "2026-10-31",
"group_by": "end_user"
}
bucket ist je nach Gruppierung der Tag, die Modellkennung, die UUID des Schlüssels oder deine Endnutzerkennung. Anfragen ohne Endnutzer und Anfragen gelöschter Endnutzer landen bei group_by=end_user gemeinsam in einem Eintrag mit bucket: null. Eine Antwort enthält höchstens 1.000 Einträge, wähle bei sehr vielen Endnutzern also kürzere Zeiträume. cost_micro_eur ist der abgerechnete Betrag in Micro-Euro, 1.840.000 entsprechen also 1,84 €.
requests zählt Anfragen, nicht einzelne Aufrufe beim Anbieter. Eine Anfrage, für die wir zusätzlich Verlauf zusammengefasst oder in Endnutzerdateien gesucht haben, bleibt eine Anfrage. Die Kosten dieser Zusatzschritte stecken aber in cost_micro_eur.
Einzelne Anfragen: GET /usage/requests
GET /v1/usage/requests listet die einzelnen Anfragen, die neueste zuerst. Jeder Eintrag enthält:
request_id, created_at, api_key, end_user, model, provider, status, error_code, latency_ms, prompt_tokens, completion_tokens und cost_micro_eur.
provider ist der Anbieter, bei dem die Anfrage tatsächlich abgerechnet wurde. request_id entspricht der flowai_request_id aus der Antwort deiner Anwendung.
Filtern kannst du mit diesen Parametern:
status, zum Beispielsuccessapi_keymit der UUID eines Schlüsselsend_usermit deiner Endnutzerkennung, also dem Wert ausexternal_identifiermodelmit der Modellkennung, wie du sie in der Anfrage geschickt hast
Seitenweise abrufen
Die Liste liefert standardmäßig 20 Einträge, mit limit bis zu 100. Steht in der Antwort has_more: true, holst du die nächste Seite mit after und dem Wert aus last_id:
curl "https://api.flowmodels.one/v1/usage/requests?limit=100&end_user=kunde-1042&after=aWQ6MTIz" \
-H "Authorization: Bearer at_dein_schluessel"
Für eine vollständige Auswertung wiederholst du das, bis has_more auf false steht.
Welchen Schlüssel du brauchst
Beide Endpunkte funktionieren mit einem Schlüssel der Berechtigung KI nutzen und mit einem Schlüssel Schlüssel verwalten. Für ein Reporting-Skript empfehlen wir einen eigenen Verwaltungsschlüssel, der keine Modelle aufrufen kann. Schlüssel aus dem FlowSuite-Abo werden hier mit 403 insufficient_key_scope abgelehnt.
Keine Inhalte
Den Text deiner Anfragen und die Antworten des Modells liefern diese Endpunkte nie, auch nicht auszugsweise. Für die Klärung eines einzelnen Aufrufs wendest du dich mit der request_id an den Support. Was wir wie lange speichern, steht in Welche Daten FlowModels speichert und wie lange.
Wenn etwas nicht klappt
Bei falschen Parametern antwortet die API mit 400 invalid_field_value und einer verständlichen Meldung, zum Beispiel:
- „Der Parameter group_by kennt nur day, model, api_key und end_user.“
- „Der Parameter start muss ein Datum im Format JJJJ-MM-TT sein.“
- „Der Parameter start darf nicht nach end liegen.“
Lieber in der Oberfläche auswerten? Dann nimm Verbrauch auswerten und als CSV exportieren.