Skip to main content
TokModel uses a prepaid credit system. You add credits to your account in advance, and each API request deducts an amount based on the number of tokens processed and the pricing tier of the model you called. There are no subscriptions or monthly minimums — you pay only for what you use.

​
How credits are calculated

Each request consumes credits according to two factors:
  • Token usage — the number of input and output tokens processed by the model.
  • Model price multiplier — each model has a ratio that reflects its underlying cost. Higher-capability models typically have a higher multiplier.
You can view the price multiplier for every available model on the TokModel pricing page.

​
Checking your balance

Your current credit balance is always visible in the TokModel console. The console shows:
  • Your available balance.
  • A usage history broken down by request, model, and token count.
You can also see per-request costs in the console’s usage log, which is useful for estimating how far your credits will go across different models.

​
Adding credits

To add credits to your account, go to the top-up page in the console. Credits are added to your account immediately after payment. There is no automatic top-up — you need to add credits manually when your balance runs low.
When your credit balance reaches zero, all API requests will fail with a 403 error. Check your balance regularly and top up before your credits are exhausted to avoid interruptions.

​
What happens when credits run out

If your balance is zero at the time of a request, TokModel rejects the request and returns a 403 Forbidden response. No partial requests are processed. To resume making requests, add credits from the top-up page. A 403 response due to insufficient credits looks like this: 
{
  "error": {
    "message": "Insufficient credits. Please top up your account to continue.",
    "type": "insufficient_credits",
    "code": 403
  }
}
If you receive an unexpected 403, check your balance in the console before investigating other causes such as API key validity.