Usage & analytics

View usage in Dashboard → Usage or query account endpoints for summaries and exports.

Summary

GET /v1/account/usage returns totals for a period, by default the current calendar month (UTC). Optional query parameters: from and to (RFC 3339), provider, model, modality.

curl "https://ozeye.ai/v1/account/usage?from=2026-09-01T00:00:00Z&to=2026-10-01T00:00:00Z&model=glm-5.3" \
  -H "Authorization: Bearer $OZEYE_API_KEY"

{
  "total_requests": 42,
  "total_input_tokens": 123456,
  "total_cached_input_tokens": 20480,
  "total_output_tokens": 34567,
  "total_cost_eur": 1.2345,
  "period_start": "2026-09-01T00:00:00Z",
  "period_end": "2026-10-01T00:00:00Z"
}

Export

Use GET /v1/account/usage/export?format=csv or ?format=json (same filters) to download one row per request.

What usage contains

• Provider, model, modality, input, cached input and output tokens (or seconds, characters or images for audio and image models), latency, routing strategy, timestamp and EUR cost.
• Prompts, messages, audio contents, image prompts, and provider response bodies are never stored.
• Detailed rows are kept for 24 months, then reduced to monthly totals. See data retention.