Models, account and usage

These endpoints let your software introspect the key it is using. All accept the same bearer key as chat completions.

GET /v1/models#

Lists the models the key may call, in the OpenAI list shape.

{ "object": "list", "data": [ { "id": "echo", "object": "model", "owned_by": "faelith" }, ... ] }

GET /v1/account#

Returns the account behind the key: display name, email, and active plan.

GET /v1/usage#

Returns the rolling meters for the key's purpose. Every meter has used, limit, remaining and exhausted, expressed in micro-dollars of list-price debit.

{
  "plan": "pro",
  "usage": {
    "code_5h": { "used": 1210000, "limit": 3730000, "remaining": 2520000, "exhausted": false },
    "code_weekly": { "...": "..." },
    "chat_5h": { "...": "..." }
  },
  "available_resets": 1
}

POST /v1/billing/usage-based#

{ "enabled": true } lets Code and Chat continue from the prepaid wallet once a meter is exhausted. Equivalent to the toggle under Billing.

POST /v1/billing/usage-reset/redeem#

Consumes the oldest unused usage reset grant and zeros the rolling meters immediately. Returns the new usage snapshot. Resets are included with yearly plans and sold in the dashboard.