GET
/
api
/
v1
/
generate
/
credit
Get Remaining Credits
curl --request GET \
  --url https://api.sunoapi.org/api/v1/generate/credit \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "msg": "success",
  "data": 100
}

​
Usage Guide

  • Credits are consumed when generating music, lyrics, or using other processing features.
  • This endpoint allows you to check your current credit balance before initiating tasks.
  • Returns a single integer value representing your available credits.
  • No parameters required; authentication via API key is sufficient.

​
Developer Notes

  1. Monitor your credit balance regularly to avoid service interruptions.
  2. If credits are insufficient, generation tasks will fail with error code 429.
  3. Consider integrating this check before starting expensive generation operations.
  4. This endpoint is lightweight and can be called frequently as needed.

Authorizations

​
Authorization
string
header
required

🔑 API Authentication

All endpoints require authentication using Bearer Token.

Get API Key

  1. Visit the API Key Management Page to obtain your API Key

Usage

Add to request headers:

Authorization: Bearer YOUR_API_KEY

⚠️ Note:

  • Keep your API Key secure and do not share it with others
  • If you suspect your API Key has been compromised, reset it immediately from the management page

Response

200
application/json

Request successful

The response is of type object.