AI Credits

The AI endpoint (GET /v1/ai) runs on its own AI credit pool, completely separate from your monthly API request limit. Calling AI never consumes API requests, and API calls never consume AI credits.

How AI is metered

• Each AI request consumes 1 AI credit.
• Your plan includes a monthly AI credit allowance that resets every billing cycle (see the table on Billing & Limits).
• You can top up any plan with purchased credit add-ons that never expire.

The two buckets, and the order they’re used

1. Monthly allowance, used first. Resets to your plan’s allowance at the start of each billing cycle. Unused monthly credits do not roll over.
2. Purchased balance, used only after the monthly allowance is exhausted. Never expires; carries across billing cycles, upgrades, and downgrades.

When both are exhausted, AI requests are hard-blocked with 429, there is no over-usage billing for AI. To keep going, purchase more credits or wait for the next cycle. (Admins can also grant credits.)

Example

Monthly allowance 5,000, of which 4,900 are already used (100 left). Purchased balance 10,000. A request that costs 200 credits:

• 100 are taken from the monthly allowance (now exhausted), and
• 100 are taken from the purchased balance.
• Purchased balance becomes 9,900.

AI Credit add-ons

One-time purchases (not a subscription), bought from the Usage page in your dashboard. Purchased credits never expire.

Add-ons are billed through Dodo Payments as a one-time charge; credits land on your balance as soon as the payment succeeds.

Seeing your usage

The dashboard Usage page shows your current plan, API usage (used / remaining), monthly AI credits used and remaining, your purchased balance, team seats, and your billing cycle, plus a Purchase Credits button.

Resets & retention

• Monthly allowance resets each billing cycle.
• Purchased balance is never removed on a reset, upgrade, or downgrade.