Zum Hauptinhalt springen
DokumentationDevelopers

Nutzung und Request-Logs

Lies die Token-Nutzung deiner Organisation und das Log jeder Anfrage über die Management-API.

Menü der Dokumentation

Nutzung und Request-Logs antworten auf dem Host deiner Console mit demselben API-Key. Der Inhaber des Keys braucht die Berechtigung usage.read für die gesamte Organisation oder usage.read_own für seine eigenen Anfragen. Die Console zeigt dieselben Daten unter Usage und Request logs.

Nutzungsübersicht

export CCSIO_CONSOLE_URL="https://console.eu.ccsio.ai"

# Totals per model and per key for October (UTC; "to" is exclusive). Without from and to: the last 7 days.
curl "$CCSIO_CONSOLE_URL/metering/v1/usage/summary?from=2026-10-01T00:00:00Z&to=2026-11-01T00:00:00Z" \
  -H "Authorization: Bearer $CCSIO_API_KEY"

Die Übersicht gruppiert die Nutzung des Zeitfensters nach Modell (models), nach Verursacher (by_principal) und nach UTC-Tag (series). Schränke sie mit model_alias, api_key_id, principal oder operation_class (inference oder tool) ein.

Request-Logs

Ein Eintrag pro Anfrage, neueste zuerst, mit Status, Dauer, Zeit bis zum ersten Token, Tokens und Verursacher. Filtere nach model, api_key_id, team, session, operation oder status und blättere mit cursor:

# One page of the request log, newest first. Pass next_cursor as cursor for the next page.
curl "$CCSIO_CONSOLE_URL/metering/v1/organizations/acme/request-logs?limit=50" \
  -H "Authorization: Bearer $CCSIO_API_KEY"
JSON
{
  "request_id": "req-01k7yqa2c4e6g8j0m2p4r6t8v0",
  "occurred_at": "2026-10-14T16:41:02Z",
  "operation": "chat",
  "http_status": 200,
  "outcome": "success",
  "error_code": null,
  "session_id": "sess-7f3a",
  "api_key_id": "01K7YQ4D8M2P6S9V3X5Z7B1C4F",
  "duration_ms": 1840,
  "ttft_ms": 212,
  "tokens": { "input": 412, "output": 697, "total": 1109 },
  "measurement": "measured",
  "measurement_reason": null,
  "quantities": [
    { "unit": "input_tokens", "amount": "412" },
    { "unit": "output_tokens", "amount": "697" }
  ],
  "end_user": {
    "principal_ref": "svc/01K7YP2C9W4X5E8H3J6M0N1Q2R",
    "principal_class": "service",
    "email": null,
    "display_name": "billing-app"
  },
  "team_id": "platform",
  "model": "qwen3.8-flash-next",
  "attempts": 1
}
Ein Eintrag aus request_logs.
Plattform entdecken

Deinen ersten API-Key holen

Die Registrierung ist offen. Vier Schritte bis zum ersten Aufruf: Konto erstellen, Organisation anlegen, API-Key erzeugen, loslegen.

  1. 01Konto erstellen
  2. 02Organisation anlegen
  3. 03API-Key erzeugen
  4. 04Loslegen