Alla usage-endpoints kräver din API-nyckel och returnerar bara ditt eget kontos data. Använd dem för dashboards, budgetlarm eller för att låta en agent hålla koll på sin egen förbrukning.

Snabbaste vägen: hela bilden i ett anrop

GET /v1/usage/summary samlar aktuellt fönster, daglig serie, fördelning per modell och rate-limit-händelser i ett svar. Bra för verktyg som annars skulle polla flera endpoints.

bash

curl "https://api.staik.se/v1/usage/summary?days=30" \
  -H "Authorization: Bearer sk-st-your-key"

json

{
  "current": {
    "tokens_used": 1200,
    "tokens_limit": 250000,
    "tokens_used_today": 1200,
    "daily_limit": 250000,
    "tokens_used_hour": 0,
    "hourly_limit": null,
    "requests_today": 8,
    "plan_name": "Hobby",
    "purchased_tokens_remaining": 0
  },
  "days": 30,
  "daily": [{ "day": "2026-09-09", "tokens": 1200, "requests": 8 }],
  "by_model": [{ "model": "qwen3.6:35b-a3b", "tokens": 1200, "requests": 8 }],
  "rate_limits": { "total": 0, "breakdown": {} }
}

days styr fönstret för daily, by_model och rate_limits (default 30, klampas till 1–90). current gäller alltid nuvarande fönster.

Kanoniska endpoints

Endpoint	Returnerar
`GET /v1/usage`	Aktuellt fönster för dashboarden: förbrukning, gränser, requests idag, senaste anrop, köposition (prioriterade planer)
`GET /v1/usage/summary?days=N`	Allt nedan i ett anrop (se ovan)
`GET /v1/usage/history?days=N`	Daglig serie `{ day, tokens, requests }`, nollpaddad per dag
`GET /v1/usage/models?days=N`	Fördelning per modell `{ model, tokens, requests }`
`GET /v1/usage/rate-limits?days=N`	Antal gånger du slog i taket, totalt + per orsak

N klampas till 1–90 dagar (default 30).

Alias

För att slippa gissa finns tre alias som ger identiskt svar som sin kanoniska motsvarighet: GET /v1/usage/daily (= history), GET /v1/usage/by-model (= models) och GET /v1/usage/limits (= rate-limits).

Exempel: daglig serie