docs.sunoapi.org
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Support
Suno APICommon API
File Upload API
Suno APICommon API
File Upload API
  1. Common API
  • Get Remaining Credits
    GET
  1. Common API

Get Remaining Credits

GET
/api/v1/generate/credit
Retrieve the current balance of available credits for your account.

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.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or

Responses

🟢200Success
application/json
Request successful
Bodyapplication/json

🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://apibox.erweima.ai/api/v1/generate/credit' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
    "code": 200,
    "msg": "success",
    "data": 100
}
Built with