Calls and compute for a month

GET

/v1/usage

const url = 'https://api.pensievelabs.co/v1/usage?month=2026-11';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.pensievelabs.co/v1/usage?month=2026-11' \
  --header 'Authorization: Bearer <token>'

Authorizations

bearer

Parameters

Query Parameters

month

string

/^[0-9]{4}-[0-9]{2}$/

The month as YYYY-MM; this month if left out.

Example

2026-11

Responses

200

Usage for the month.

application/json

Calls and compute for a month. Plans are priced per model per month, so nothing here is a bill.

object

object

required

Allowed value: usage

month

required

string

models

required

Array<object>

object

model

required

string

calls

required

integer

fallback_calls

required

Calls your own code answered.

integer

serving_cost_usd

required

What serving the calls cost on the GPUs the model runs on.

number

frontier_cost_usd

required

What the same calls would cost on the best frontier model.

number

experiments_usd

required

Compute spent on experiments this month.

number

experiments_budget_usd

required

The monthly cap on experiment compute.

number | null

Example

{
  "object": "usage",
  "month": "2026-11"
}

default

Something went wrong; error.type says what.

application/json

object

error

required

object

type

required

string

Allowed values: invalid_request authentication permission not_found conflict rate_limit not_available server

message

required

string

param

The request field the error is about.

string | null

request_id

required

string

Example

{
  "error": {
    "type": "invalid_request"
  }
}