Usage and billing

Read what you have used and what is left. Everything is in US dollars.

Dollars, prepaid

Everything is billed in US dollars from the organization's prepaid balance. Amounts in the API are numbers of dollars, such as 0.0021 , so a single request can cost a fraction of a cent. Add funds under Billing; when the balance reaches zero, requests are refused until you add more.

Balance

GET

/v1/balance

The organization's available balance.

Key permission: Usage and balance: Read

EXAMPLE

curl

JavaScript

Python

curl https://api.decillionai.com/v1/balance \
  -H "Authorization: Bearer $DECILLION_API_KEY"

Response

{
  "available": 42.5,
  "held": 0,
  "currency": "USD"
}

Usage

GET

/v1/usage

Spend and request counts over a period.

Key permission: Usage and balance: Read

QUERY PARAMETERS

days

integer

How many days back, up to 90. Defaults to 30.

group_by

string

day (default), model , key or service .

EXAMPLE

curl

JavaScript

Python

curl https://api.decillionai.com/v1/usage?days=7&group_by=model \
  -H "Authorization: Bearer $DECILLION_API_KEY"

Response

{
  "total": { "spend": 15.7, "requests": 147, "input_tokens": 133000, "output_tokens": 26000, "currency": "USD" },
  "data": [
    { "model": "google/gemini-3.8-flash", "spend": 9.4, "requests": 98, "tokens": 101000 },
    { "model": "openai/gpt-5-mini", "spend": 6.3, "requests": 49, "tokens": 58000 }
  ]
}

Storage

Limits