API Credits
Monitor your API credit usage and manage your credit balance for seamless API access.
API credits are how you pay for GreenPT API usage. Top up your balance once, then every API call deducts credits based on the model and the size of the request and response.
How API credits work
Each API call consumes credits based on:
- The model used: different models have different per-token pricing. See the full pricing breakdown.
- The size of your request: input tokens (the prompt, system messages, and any context you send).
- The size of the response: output tokens generated by the model.
- Service-specific metering: speech-to-text is billed per minute of audio rather than per token; embeddings and reranking only charge for input tokens.
Your remaining credit balance is shown in the GreenPT account dashboard and
also returned in the x-credit-balance response header on every API call.
Top up your balance
Buy credits from the account portal. Common top-up amounts are pre-set, or you can specify a custom amount.
Credits don't expire. Unused credits roll over indefinitely, you only pay for what you consume.
What happens if you run out?
If your balance hits zero, API requests return 402 Payment Required until
you top up again. Existing in-flight requests are not interrupted; only new
requests are rejected.
Set up a low-balance alert in the account portal so you don't get surprised, you'll receive an email when your remaining credits drop below a threshold you configure.