Usage & Analytics

Track requests, tokens, and costs per key, provider, and model. Every API response includes usage metadata.

Response Metadata

Every response includes:

{
  "id": "req_abc123...",
  "provider_used": "groq",
  "model": "llama-3.3-70b-versatile",
  "content": "...",
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 45,
    "total_tokens": 57
  },
  "cost_usd": 0.000034
}

Dashboard

Overall Usage

/usage — daily requests, tokens, costs across all keys

Per-Key Usage

/keys/{id} — detailed stats, timeseries, request history

API Endpoints

GET/v1/usage/summaryTotal tokens and costs
GET/v1/usage/by-providerCosts grouped by provider
GET/v1/usage/by-modelCosts grouped by model
GET/v1/usage/historyDetailed request history
GET/v1/keys/{id}/usagePer-key usage stats
GET/v1/keys/{id}/usage/timeseriesDaily timeseries for a key
GET/v1/keys/{id}/historyRequest history for a key