​

Music Generation API

The Music Generation API allows you to create original music tracks from text prompts. Powered by advanced AI models, it can generate various musical styles, instrumentation, and moods.

​

Overview

Create AI-generated music by providing text prompts that describe the style, mood, and instrumentation you want. The API handles the request asynchronously:

1. Submit a generation request with your prompt
2. Receive a task ID for tracking
3. Check the status until completion
4. Download the generated music file

​

Base URL

https://api.taam.cloud/suno/submit/music

​

Request Format

curl --location 'https://api.taam.cloud/suno/submit/music' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "prompt": "An upbeat electronic dance track with energetic synths and a catchy hook",
    "tags": "electronic, dance, upbeat",
    "title": "Dance Energy",
    "mv": "v5"
}'

​

Parameters

​

Response Format

{
  "status": "success",
  "data": {
    "task_id": "mus_bVDqJBrLStaPbCZXvLZrWqi4",
    "estimated_completion_time": 120
  }
}

​

Checking Generation Status

Once you have a task_id, you can check the status of the music generation:

curl --location 'https://api.taam.cloud/suno/music/status/mus_bVDqJBrLStaPbCZXvLZrWqi4' \
--header 'Authorization: Bearer YOUR_API_KEY'

​

Status Response Format

{
  "status": "completed",
  "data": {
    "task_id": "mus_bVDqJBrLStaPbCZXvLZrWqi4",
    "audio_url": "https://storage.taam.cloud/music/mus_bVDqJBrLStaPbCZXvLZrWqi4.mp3",
    "cover_image": "https://storage.taam.cloud/music/covers/mus_bVDqJBrLStaPbCZXvLZrWqi4.jpg"
  }
}

Status codes:

• queued: Task is in the queue
• processing: Music is being generated
• completed: Generation is complete
• failed: Generation failed

​

Prompt Tips

​

Example Prompts

{
  "prompt": "A futuristic electronic track with glitchy beats, atmospheric pads, and a driving bassline that evolves throughout",
  "tags": "electronic, ambient, glitch",
  "title": "Digital Horizon"
}

​

Limitations

• Generated tracks are typically 1-2 minutes in length
• Specific artist names should be used as inspiration only, not direct copying
• Vocals are generated in a fictional language
• Maximum of 50 active generations per account at once