Usage

Usage shows how much your service has spent today, how close it is to its daily budget, and what it has spent so far this month. Days and months are counted in UTC.

GET/v1/usage

Get today's usage

Returns the running totals for your service since midnight UTC, and since the first of the month. Totals include every model call made through Chat, Objects and Agents. Spend is each call's tokens multiplied by the catalog price when the call ran.

Response

Name
serviceId
Type
string
Description
Your service.
Name
projectId
Type
string
Description
The Mantle project your calls are billed to.
Name
budgetUsd
Type
number
Description
Your daily budget.
Name
day
Type
string
Description
The UTC day these totals cover, YYYY-MM-DD.
Name
usd
Type
number
Description
Spend so far today.
Name
calls
Type
integer
Description
Model calls so far today.
Name
inputTokens
Type
integer
Description
Input tokens so far today.
Name
outputTokens
Type
integer
Description
Output tokens so far today.
Name
month
Type
object
Description
This month so far: month (YYYY-MM), usd, calls, inputTokens, outputTokens, plus failed — model calls that failed, with nothing recorded as spent — and timeouts, the failed calls that timed out.

Request

GET

/v1/usage

curl https://api.llm.vovix.io/v1/usage \
  -H "x-api-key: $LLM_API_KEY"

Response

{
  "serviceId": "pixora",
  "projectId": "proj_36xdnmmcwulwzvhukzhf",
  "budgetUsd": 2,
  "day": "2026-09-12",
  "usd": 0.000178,
  "calls": 9,
  "inputTokens": 1204,
  "outputTokens": 371,
  "month": {
    "month": "2026-09",
    "usd": 0.004213,
    "calls": 206,
    "inputTokens": 27114,
    "outputTokens": 8820,
    "failed": 1,
    "timeouts": 0
  }
}