Usage and balance
| Endpoint | Returns |
|---|---|
GET /api/v1/billing/balance |
Available balance |
GET /api/v1/billing/usage?days=30 |
Consumption by day (input tokens and cost); never decisions |
GET /api/v1/billing/ledger |
Every charge, refund and top-up |
POST /api/v1/billing/checkout |
A Stripe Checkout link to top up |
print(client.balance(), client.usage(days=30))
Sandbox keys are never billed and do not appear in usage. See Sessions and billing.