Skip to main content
GET
/
v1
/
credits
Retrieve credit balance
curl --request GET \
  --url https://supertoneapi.com/v1/credits \
  --header 'x-sup-api-key: <api-key>'
{
  "balance": 123
}
Returns the current credit balance for the account that owns the API key. The Supertone API and Supertone Play share the same credit pool — credits purchased in either are immediately available to both.

​
Endpoint

GET https://supertoneapi.com/v1/credits

​
Notes

  • Credits are deducted per second of generated audio.
  • Both preset voices and custom voices draw from the same balance.
  • New accounts may receive trial credits on registration.
  • predict_duration does not deduct credits — use it to forecast cost.

​
See also

Docs: Cost and usage

How to monitor spend and set up balance alerts.

Predict duration

Forecast audio length (and cost) before generating.

Authorizations

​
x-sup-api-key
string
header
required

Response

Credit balance of the user.

​
balance
number | null
required

Credit balance of the user