FlowModels

Verbrauch per API auswerten: GET /usage und GET /usage/requests

Veröffentlicht am 11. November 2026

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"
  • start und end sind Tage im Format JJJJ-MM-TT. Ohne Angabe bekommst du die letzten 30 Tage bis heute.
  • group_by bestimmt die Aufteilung: day (Standard), model, api_key oder end_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 Beispiel success
  • api_key mit der UUID eines Schlüssels
  • end_user mit deiner Endnutzerkennung, also dem Wert aus external_identifier
  • model mit 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.

War dieser Artikel hilfreich?

Zurück zu Verbrauch & Protokolle