Du kannst diese Exporte auch direkt in der Langdock-Oberfläche erstellen. Mehr dazu findest du unter Nutzungsexporte.
Voraussetzungen
Um die Usage Export API zu nutzen, benötigst du:- Workspace-Admin-Berechtigung: Nur Workspace-Administratoren können API-Schlüssel mit Nutzungsexport-Berechtigung erstellen.
- API-Schlüssel mit
USAGE_EXPORT_APIScope: Spezielle Berechtigung für den Zugriff auf Nutzungsexporte.
Programmatischer Export
Verfügbare Endpunkte
agents und assistants geben die gleichen Daten zurück. agents ist ein Alias.Authentifizierung
Alle Anfragen benötigen Bearer-Token-Authentifizierung:Anfrageformat
Die API nutzt die Uhrzeit aus demdate-Wert und interpretiert sie in der angegebenen timezone. Wenn du ein Z am Ende des date-Werts angibst, entfernt Langdock dieses automatisch, damit die Zeitzone nicht doppelt angewendet wird.
group_by ist optional. Unterstützte Werte hängen vom Exporttyp ab:
Antwortformat
CSV-Antwort
CSV-Endpunkte geben einen Dateipfad und eine Download-URL zurück:JSON-Antwort
JSON-Endpunkte geben die Zeilen direkt zurück:Fehlerantwort
Beispielanfrage
Export-Limits
Jede Anfrage an die Usage Export API kann bis zu 1.000.000 Nutzungszeilen verarbeiten. Dieses Limit gilt für die Standard-, CSV- und JSON-Endpunkte. Anfragen über diesem Limit geben400 Bad Request mit dem Code USAGE_EXPORT_TOO_LARGE zurück. Exportiere jeweils einen Monat und füge die Ergebnisse anschließend zusammen.
Rate Limits
Die Usage Export API unterliegt einem Limit für Anfragen, das je Workspace und API-Key begrenzt wird. Das Token-Limit der Completion-Endpunkte gilt hier nicht.- Anfragen pro Minute: 500 Anfragen/Min
Details zu Endpunkten
- Nutzer-Nutzung exportieren
- Agenten-Nutzung exportieren
- API-Schlüssel-Nutzung exportieren
- Projekt-Nutzung exportieren
- Modell-Nutzung exportieren