Get usage

from prysm import Prysm

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

import { Prysm } from "@prysmai/sdk";

const client = new Prysm();
console.log(await client.usage());

curl https://api.prysm1.com/v1/usage \
  -H "Authorization: Bearer $PRYSM_API_KEY"

{
  "user_id": "usr_demo",
  "plan": "free",
  "plan_display": "Free",
  "limits": {
    "daily_requests": 1000,
    "rpm": 10,
    "daily_requests_used": 128,
    "daily_requests_remaining": 872,
    "model_access": {
      "type": "allowlist",
      "models": ["gemini-2.5-flash-lite", "gpt-5-nano", "mistral-nemo"]
    }
  },
  "total_requests": 128,
  "total_tokens": 512340,
  "total_cost_usd": 0.2145,
  "by_model": {
    "mistral-nemo": { "requests": 90, "tokens": 360000, "cost_usd": 0.0072 }
  },
  "by_provider": {
    "mistral": { "requests": 90, "tokens": 360000, "cost_usd": 0.0072 }
  },
  "by_mode": {
    "balanced": { "requests": 100, "tokens": 420000, "cost_usd": 0.0084 }
  },
  "recent": []
}

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

string

required

Your secret key as a bearer token: Bearer prysm_sk_...

Response

string

The account this key belongs to.

string

Plan ID: free | personal | pro | corporate.

string

Human-readable plan name (e.g. "Pro").

object

Current plan limits and live consumption counters — useful for building dashboards or checking headroom before an API call.

Field	Type	Description
`daily_requests`	`integer \| null`	Max requests per 24h. `null` = unlimited.
`rpm`	`integer`	Max requests per minute.
`daily_requests_used`	`integer`	Requests made in the last 24h.
`daily_requests_remaining`	`integer \| null`	Headroom left today. `null` = unlimited.
`model_access.type`	`"all" \| "allowlist"`	Whether all models are accessible or only a subset.
`model_access.models`	`string[] \| null`	Explicit allowlist (Free plan only); `null` for all-access plans.

integer

Total requests made (all time).

integer

Total tokens (input + output).

number

Total spend, USD.

object

Per-model breakdown, keyed by model ID — each with requests, tokens, cost_usd.

object

Per-provider breakdown, same shape as by_model.

object

Per-mode breakdown (quality / balanced / agility / direct), same shape.

object[]

The most recent requests (newest first).

from prysm import Prysm

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

import { Prysm } from "@prysmai/sdk";

const client = new Prysm();
console.log(await client.usage());

curl https://api.prysm1.com/v1/usage \
  -H "Authorization: Bearer $PRYSM_API_KEY"

{
  "user_id": "usr_demo",
  "plan": "free",
  "plan_display": "Free",
  "limits": {
    "daily_requests": 1000,
    "rpm": 10,
    "daily_requests_used": 128,
    "daily_requests_remaining": 872,
    "model_access": {
      "type": "allowlist",
      "models": ["gemini-2.5-flash-lite", "gpt-5-nano", "mistral-nemo"]
    }
  },
  "total_requests": 128,
  "total_tokens": 512340,
  "total_cost_usd": 0.2145,
  "by_model": {
    "mistral-nemo": { "requests": 90, "tokens": 360000, "cost_usd": 0.0072 }
  },
  "by_provider": {
    "mistral": { "requests": 90, "tokens": 360000, "cost_usd": 0.0072 }
  },
  "by_mode": {
    "balanced": { "requests": 100, "tokens": 420000, "cost_usd": 0.0084 }
  },
  "recent": []
}

Use GET /v1/savings to compute estimated savings versus an all-premium baseline in one call — or call client.savings() in the Python and Node SDKs for the same result.

Plans Get savings

Overview

Endpoints

Agentic Control Plane

Agentic Control Plane

Authorization

Response

​Authorization

​Response

Authorization

Response