Echtzeit-Kostenüberwachung und Token-Tracking für alle KI- und LLM-Aufrufe (REST & MCP).

Cost Control & Tracking API

Liberino verfügt über ein kontinuierliches, persistentes Kosten- und Token-Tracking. Jede KI-Aktion (Text-Extraktion, Szenengenerierung, visuelles Clustering, Bounding-Box-Erkennung, Bildgenerierung) wird in Echtzeit gemessen, bewertet und sowohl in der Konsole als auch über REST-Endpunkte und MCP-Tools bereitgestellt.

1. Automatische Terminal-Ausgabe

Nach jeder einzelnen KI-Aktion protokolliert das System den exakten Verbrauch der Aktion sowie die kumulierte Summe der letzten 24 Stunden direkt in den Logs:

💰 [AI COST TRACKER] Action: "entity-extraction" (gemini-2.5-flash)
   ├─ Verbrauch:     2.140 in / 480 out
   ├─ Kosten Aktion: 0.00028 € ($0.00030)
   ├─ Letzte 24h:    0.0452 € ($0.0491) across 34 actions
   └─ Gesamt:        0.1824 € ($0.1983)

2. REST Endpunkte

`GET /api/costs` & `GET /api/costs/summary`

Liefert die aggregierte Kostenübersicht für die letzten 24 Stunden, 7 Tage, 30 Tage und All-Time sowie Aufschlüsselungen nach Modell und Aktion.

Query-Parameter

Parameter	Typ	Standard	Beschreibung
`hours`	`number`	`24`	Zeitfenster in Stunden für die Aufschlüsselung nach Modell/Aktion.

Beispiel-Antwort:

{
  "success": true,
  "timestamp": "2026-10-15T00:00:00.000Z",
  "timeWindowHours": 24,
  "currency": "EUR",
  "usdToEurRate": 0.92,
  "last24h": {
    "costEur": 0.0452,
    "costUsd": 0.0491,
    "formattedEur": "0.0452 €",
    "formattedUsd": "$0.0491",
    "actionsCount": 34,
    "inputTokens": 142000,
    "outputTokens": 28400,
    "imagesCount": 2
  },
  "allTime": {
    "costEur": 0.1824,
    "costUsd": 0.1983,
    "formattedEur": "0.1824 €",
    "formattedUsd": "$0.1983",
    "actionsCount": 150
  },
  "byModel": {
    "gemini-2.5-flash": {
      "costEur": 0.0210,
      "costUsd": 0.0228,
      "actionsCount": 30,
      "tokens": 120000
    },
    "gemini-2.5-pro": {
      "costEur": 0.0242,
      "costUsd": 0.0263,
      "actionsCount": 4,
      "tokens": 50400
    }
  },
  "byAction": {
    "entity-extraction": { "costEur": 0.0185, "costUsd": 0.0201, "actionsCount": 18 },
    "visual-clustering": { "costEur": 0.0267, "costUsd": 0.0290, "actionsCount": 16 }
  },
  "recentEvents": [ ... ]
}

`GET /api/costs/events`

Gibt die jüngsten Einzel-Ereignisse mit Zeitstempel, Aktionsname, Token-Zahlen und Kosten zurück.

Query-Parameter

Parameter	Typ	Standard	Beschreibung
`limit`	`number`	`50`	Anzahl der zurückzugebenden Events (max. 200).

`POST /api/costs/track`

Ermöglicht externen Clients, Frontend-Worker oder Skripten, manuelle KI-Nutzung in das zentrale Ledger einzuspeisen:

{
  "action": "client-epub-analysis",
  "model": "gemini-2.5-flash",
  "inputTokens": 1500,
  "outputTokens": 300,
  "imagesCount": 0
}

3. Model Context Protocol (MCP) Tool

Für autonome Coding-Agenten und LLM-Tools ist der Cost Tracker nativ im MCP-Server registriert:

`get_cost_summary`

Beschreibung: Liefert eine prägnante Text-Zusammenfassung und strukturierte JSON-Daten des KI-Verbrauchs (letzte 24h, All-Time, Kosten nach Modellen und Aktionen).
Parameter:
- hours (optional, Zahl, Default 24): Betrachtetes Zeitfenster in Stunden.
Rückgabe: Formatierter Textbericht für das Prompt-Fenster + vollständiges JSON-Objekt.

Cost Control & Tracking API

On this page