Skip to main content
GET https://api.prysm1.com/v1/usage · Requires authentication
Returns aggregated usage for the authenticated key: total requests, tokens, and cost, broken down by model, provider, and mode, with the most recent calls.

​
Authorization

​
Authorization
string
required
Your secret key as a bearer token: Bearer prysm_sk_...

​
Response

​
user_id
string
The account this key belongs to.
​
plan
string
The account’s plan.
​
total_requests
integer
Total requests made.
​
total_tokens
integer
Total tokens (input + output).
​
total_cost_usd
number
Total spend, USD.
​
by_model
object
Per-model breakdown, keyed by model ID — each with requests, tokens, cost_usd.
​
by_provider
object
Per-provider breakdown, same shape as by_model.
​
by_mode
object
Per-mode breakdown (quality / balanced / agility / direct), same shape.
​
recent
object[]
The most recent requests (newest first).
from prysm import Prysm

client = Prysm()
print(client.usage())

{
  "user_id": "usr_demo",
  "plan": "free",
  "total_requests": 128,
  "total_tokens": 512340,
  "total_cost_usd": 0.2145,
  "by_model": {
    "deepseek-v3.2": { "requests": 90, "tokens": 360000, "cost_usd": 0.1188 }
  },
  "by_provider": {
    "deepseek": { "requests": 90, "tokens": 360000, "cost_usd": 0.1188 }
  },
  "by_mode": {
    "balanced": { "requests": 100, "tokens": 420000, "cost_usd": 0.1701 }
  },
  "recent": []
}
Combine total_tokens and total_cost_usd with the model catalog to estimate savings versus an all-premium baseline — exactly what client.savings() does in the Python and Node SDKs.