Zweck
Die Seite /ai-usage zeigt, wie viel KI SpeamCore verbraucht hat — Aufrufe, Tokens und Kosten in Euro — aufgeschlüsselt nach Quelle, Feature, Modell und Tag. So sehen Sie, welche KI-Funktionen wie stark genutzt werden und was sie kosten.
Voraussetzungen
- Berechtigung `view:FE_AiUsage` + `view:AiUsageLog`.
- Es liegen KI-Aufrufe vor (jeder KI-Lauf schreibt einen Nutzungs-Datensatz).
Berechtigungen (CASL)
| Action | Subject | Wirkung |
|---|
view | FE_AiUsage | Seite aufrufbar |
view | AiUsageLog | Nutzungs- und Kostendaten lesen |
Wie die Kosten entstehen
- Preiskatalog (
AiModelPrice): Ein täglicher Lauf zieht die aktuellen Modell-Preise (z. B. von Anthropic/OpenAI) je Token (Eingabe, Ausgabe, Cache). Ändert sich ein Preis, wird der alte Eintrag mit validTo geschlossen und ein neuer mit validFrom angelegt — so bleibt die vollständige Preis-Historie erhalten.
- Nutzungs-Log (
AiUsageLog): Jeder KI-Aufruf protokolliert Quelle, Feature, Modell, Eingabe-/Ausgabe-Tokens und friert den zum Zeitpunkt gültigen Preis ein. Dadurch bleiben historische Kosten reproduzierbar, auch wenn der Anbieter später die Preise ändert.
Pro Aufruf werden zwei Beträge geführt: `costUsd` ist der **Listenpreis des Anbieters** (USD), `costEur` der **endkundenseitige Preis in Euro** (inklusive SpeamCore-Marge). Die Auswertung auf dieser Seite zeigt die **Euro**-Kosten.
Die Auswertung
Die Seite (GET /api/ai-usage/stats) zeigt:
- KPI-Karten: Gesamtkosten (EUR), Anzahl Aufrufe, Token-Aufteilung (Eingabe/Ausgabe).
- Aufschlüsselungen mit Euro-Kosten nach:
- Quelle (
source) — welcher Teil von SpeamCore die KI gerufen hat,
- Feature (
feature) — die konkrete Funktion (z. B. KI-Website-Bewertung, Chat-Widget),
- Modell (
model),
- Tag — Verlauf über die Zeit.
Bei einigen KI-Funktionen (z. B. in der Mail-Konfiguration) zeigt eine **Kosten-Schätzungs-Karte** vorab eine grobe Hochrechnung (pro Mail/Tag/Monat), gespeist aus den bisherigen Nutzungsdaten bzw. Feature-Richtwerten.
Felder — AiUsageLog (lesend pro Aufruf)
| Feld | Bedeutung |
|---|
source | rufende Quelle innerhalb SpeamCore |
feature | konkrete Funktion (Label) |
provider / model | Anbieter + Modell |
inputTokens / outputTokens | verbrauchte Tokens |
costUsd | Anbieter-Listenpreis (USD) |
costEur | Endkundenpreis (EUR, inkl. Marge) |
Verknüpfungen zu anderen Modulen
Wiederverwendbare Konzepte
API/Schnittstellen
| Methode | Endpoint | Zweck | CASL |
|---|
GET | /api/ai-usage/stats | Aufrufe/Tokens/Kosten + Aufschlüsselungen | view AiUsageLog |
Versionshinweise
- 2026-06-30: Initiale Veröffentlichung — KI-Nutzungs- und Kosten-Auswertung (
/ai-usage) auf Basis des Preis-Systems (AiModelPrice mit Preis-Historie, AiUsageLog mit costUsd/costEur). Verifiziert an aiModelPrice.model.ts, aiUsageLog.model.ts, aiUsage.router.ts, AiUsagePage.tsx.