Skip to main content

​
GET /api/get_limit

Returns your current Suno account credit balance and billing usage by querying Suno’s /api/billing/info/ endpoint.
Check your credits before calling /api/generate. Each generation produces 2 songs and costs 10 credits. If you have fewer than 10 credits remaining, the generation request will fail with a 402 error.

​
Request

This endpoint takes no parameters.

​
Response

​
credits_left
number
required
Number of credits remaining in the current billing period.
​
period
string
required
The active billing period. Free accounts use "day" — credits reset daily.
​
monthly_limit
number
required
Total credits allocated for the month.
​
monthly_usage
number
required
Credits consumed so far this month.

​
Credit consumption

ActionCredits used
One generation request (/api/generate, /api/custom_generate)10 credits (2 songs × 5 credits each)
Free account daily allowance50 credits
Free Suno accounts receive 50 credits per day. Paid plans have higher monthly limits. When credits_left drops below 10, avoid calling generate endpoints to prevent 402 Payment Required errors.

​
Examples

​
Check your credit balance

curl "http://localhost:3000/api/get_limit"

​
Example response

{
  "credits_left": 50,
  "period": "day",
  "monthly_limit": 50,
  "monthly_usage": 0
}

​
Example response after two generations

{
  "credits_left": 30,
  "period": "day",
  "monthly_limit": 50,
  "monthly_usage": 20
}

Build docs developers (and LLMs) love

Get started for freeTalk to us