Skip to main content

​
Welcome to the Crun Suno APIs

Powered by advanced AI models, Crun Suno API offers comprehensive AI music generation and audio processing services. Whether you need to generate music, create sound effects, extend audio, or perform vocal separation, our API can meet all your creative needs.

​
Suno AI Music Models

Supports multiple music models, including the latest Suno V5 model.

V3.5

Fast Creative Output, quick idea generation.

V4

Balanced Generation Core, stable overall output.

V4.5

Better Structure Flow, improved song flow.

V4.5all

Multi-Style Support, handles diverse genres.

V4.5plus

Enhanced Vocal Control, more stable vocals.

V5

Studio-Level Quality, cleaner mix, pro sound.

V5.5

Custom Models Tailored to Your Unique Taste.

​
Music Generation APIs

Providing comprehensive AI music creation and audio processing API services.

Generate Music

Create songs from text prompts with diverse styles.

Extend Music

Continue and expand existing music seamlessly.

Extend Upload

Upload audio to extend and refine compositions.

Music Cover

Recreate songs in new styles or voices.

Music Video

Generate visuals synced to your music.

Vocal Separation

Isolate vocals and instrument tracks cleanly.

Sounds Generate

Create sound effects, ambience, and loopable audio from text prompts.

​
Getting Started

1

Choose Your Music APIs

Select the music api that best fits your use case from the categories above.
2

Get API Key

Visit the API Key Management Page to obtain your API credentials.
3

Integrate

Follow the music api specific documentation to integrate the API into your application.
4

Start Creating

Begin generating content using your chosen music api through simple API calls.

​
Best Practices

​
Authentication

All API requests need to include the API key in the request header. 
X-API-KEY: YOUR_API_KEY
Keep your API key secure. Never expose it in client-side code or public repositories.

​
Create Task

All Suno api task creation requests follow a unified outer structure. Only the input field varies by model.
Success is only achieved when both the HTTP status code and the business status code are 200.
  curl -X POST "https://api.crun.ai/api/v1/client/job/CreateTask" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -d '{
    "model": "suno/music-generate",
    "callback_url": "https://your.domain/api/v1/callback/task",
    "input": {
    "mode": "simple",
    "model": "v5",
    "instrumental": false,
    "prompt": "A modern Western R&B song with soulful female vocals, emotional and smooth tone."
}
  }'

​
Response Example

{
"code": 200,
"message": "success",
"data": {
  "task_id": "xxxx-xxxx"
}
}

​
Polling Task Status

Polling interval is recommended to be between 15 and 30 seconds. For production environments, we recommend webhook callbacks.
curl -X GET "https://api.crun.ai/api/v1/client/job/TaskInfo?task_id=xxxx-xxxx" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"

​
Response Example

{
"code": 200,
"message": "success",
"data": {
 "task_id": "suno_task_12345678",
 "provider": "Suno",
 "model_version": "sunov5",
  "status": "running",
  "param":  {
          "model": "suno/music-generate",
          "callback_url": "https://your.domain/api/v1/callback/task",
          "input": {
              "mode": "simple",
              "model": "v5",
              "instrumental": false,
              "prompt": "A modern Western R&B song with soulful female vocals, emotional and smooth tone."
          }
  },
  "create_at": 1773969449,
  "result": null,
  "duration_s": null,
  "complete_at": null
}
}
  1. The task status is determined by the status field in the response data object.
  2. When status is success, retrieve the generated media URLs from data.result.media_urls.
  3. data.result.suno_data each element is a Suno music object containing information about the track.
  4. When status is failed, check the error code and message in data.result for details.

​
Callback Notifications

Although polling is supported, webhook callbacks are strongly recommended for production systems., When providing callback_url in the task creation request, ensure the following:
  • The endpoint is publicly accessible over HTTPS.
  • It responds quickly (recommended < 3 seconds) to avoid retries.
  • It returns an HTTP 200 status code upon successful receipt.
  • It is idempotent. Callback notifications may be delivered more than once.
Callback payloads use the same structure as the task status query API, allowing a single unified parsing logic.
When the task status changes, we will notify you of the result via a POST request. The payload structure is consistent with the data object returned by the task status query. For production environments, we strongly recommend using callback notifications to retrieve task results.

​
Credits and Pricing

Different music api consume different amounts of credits based on their computational requirements. Visit the pricing page to view detailed pricing for each of our musci api. Check your remaining credits: 
curl -X POST "https://api.crun.ai/api/v1/client/account/balance" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"

​
Support

Need help choosing the right model or integrating our APIs?