Export model usage data
Usage Export API
Modell-Nutzung exportieren
API-Endpunkt zum Exportieren von Modellnutzung, Anfragezahlen und BYOK-Token-Verbrauch.
POST
Export model usage data
Dieser Endpunkt exportiert Modellnutzung für den gewählten Zeitraum.
Details zu Voraussetzungen und Rate Limits findest du in der Hauptdokumentation zur Usage Export API.
Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen. Verwende API-Schlüssel serverseitig und speichere sie sicher. Mehr dazu findest du unter Best Practices für API-Schlüssel.
Enthaltene Daten
Standardmäßig gibt der Modell-Export eine Zeile pro normalisiertem Modellnamen, Provider und BYOK-Status zurück.| Spalte | Beschreibung |
|---|---|
period_start | Startdatum des Berichts |
period_end | Enddatum des Berichts |
org_id | ID des Workspaces |
name | Normalisierter Modellname |
provider | Modellanbieter |
bring_your_keys | Ob die Nutzung über ein BYOK-Modell lief |
requests | Anzahl der Anfragen |
Zusätzliche Spalten für BYOK-Workspaces
| Spalte | Beschreibung |
|---|---|
sum_prompt_tokens | Gesamte Input-Tokens |
sum_completion_tokens | Gesamte Output-Tokens |
sum_cached_prompt_tokens | Cache-Read-Input-Tokens |
sum_cache_creation_tokens | Cache-Write-Input-Tokens |
no_cache_tokens | Input-Tokens, die nicht aus dem Cache kamen |
total_cost_usd | Geschätzte Provider-Kosten in USD |
Da BYOK-Workspaces eigene Modell-Keys bereitstellen, kann Langdock Token-Verbrauch direkt ausweisen.
Gruppierter Export
Mitgroup_by=source erhältst du eine Zeile pro Modell und Quelle, zum Beispiel WEB oder MOBILE.
BYOK-Workspaces können außerdem group_by=deployment verwenden, um eine Zeile pro Modell und Deployment zu erhalten.Autorisierungen
API key as Bearer token. Format "Bearer YOUR_API_KEY"
Body
application/json