Usage & Billing
CleverThis tracks all API token consumption and charges it against your workspace's credit wallet. The Usage & Billing page gives you full visibility into how your credits are being spent and lets you top up your wallet via Stripe.
Billing works on a prepaid credit model: you add credits to your wallet, and each token consumed by an API call deducts from your balance. Credits do not expire. If your wallet balance reaches zero, API calls will return a 402 Payment Required error until you top up.
What's in this section
- Credits — how wallet credits work and how to add them via Stripe
- Reading Usage — navigating the usage table and charts
Billing period
Usage statistics are organized by calendar month. Each request is attributed to the namespace, model, and API key that made it. The billing summary at the top of the Usage page shows:
- Current balance — credits remaining in your wallet
- This month's spend — total credits consumed since the 1st of the current month
- Top consumers — the three namespaces or models consuming the most this month
Cost calculation
The cost of each request is calculated as:
cost = (prompt_tokens × input_price + completion_tokens × output_price) / 1,000,000
Prices are denominated in credits. One credit equals one USD cent. Provider model prices reflect the upstream provider's pricing plus a small CleverThis margin. Actor endpoint pricing reflects the aggregate cost of all underlying model calls made during Actor execution.
Invoice download (PDF), usage export (CSV), and per-API-key spend reports are being added to the Usage & Billing page.