Music Generation

Generate AI music with Suno models. Create songs with lyrics, instrumentals, and custom styles from text prompts.

Available Models

Model Name	Description	Credits
`suno-v5_5`	Suno V5.5 - Tailored custom models for personalized taste	24 credits
`suno-v5`	Suno V5 - Superior expression, faster generation	24 credits

When a request fails, the API returns a JSON error response:

{
  "error": {
    "code": "insufficient_credits",
    "message": "Your credit balance is too low. Please top up.",
    "type": "billing_error"
  }
}

HTTP Status	Code	Type	Description
400	`invalid_request`	invalid_request_error	Missing or invalid parameters
401	`invalid_api_key`	authentication_error	API key is invalid, disabled, or deleted
402	`insufficient_credits`	billing_error	Credit balance too low, please top up
403	`ip_not_allowed`	permission_error	Request IP not in the key's allowlist
404	`model_not_found`	invalid_request_error	Model does not exist or is inactive
404	`task_not_found`	invalid_request_error	Task ID does not exist
429	`rate_limit_exceeded`	rate_limit_error	Too many requests, please slow down
429	`spend_limit_exceeded`	billing_error	Key spend limit reached (hourly/daily/total)
500	`internal_error`	api_error	Unexpected server error
503	`upstream_error`	upstream_error	Upstream AI provider returned an error

Returned when required fields are missing or invalid.

{
  "error": {
    "code": "invalid_request",
    "message": "'model' is required.",
    "type": "invalid_request_error"
  }
}

Your balance is too low. Check your balance with GET /v1/credits and top up in Dashboard > Billing.

Possible causes:

The upstream AI provider returned an error. This may happen when:

Credits are automatically refunded when a task fails due to upstream errors.