BillingGuide
Balance and top-ups
What the balance is, when it blocks a request, and how it is credited.
By the end: You know why a request returns 402 and how to restore access.
The balance is a prepaid amount in USD, held to six decimal places internally.
When it blocks a request
A balance at or below zero refuses model requests with 402 and the code insufficient_balance. Listing models still works, so a client can discover what is available before you top up.
Adding credit
Redeem a code from the dashboard, or ask an administrator to adjust the account. Both appear in your credit activity with a reference you can quote.
Avoiding a hard stop mid-job
- Watch the balance on the dashboard before a large batch.
- Set max_tokens so a single request cannot consume an unbounded amount.
- Treat a 402 as a distinct case in your client, separate from 401 and 429.