"Suno Music API Tutorial: Generate AI Music Programmatically in 2026"

pip install openai requests

import requests
import time

API_KEY = "your-crazyrouter-key"
BASE_URL = "https://api.crazyrouter.com"

# Step 1: Submit a music generation request
response = requests.post(
    f"{BASE_URL}/suno/submit/music",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "prompt": "A chill lo-fi hip hop beat with soft piano and vinyl crackle, perfect for studying late at night",
        "tags": "lo-fi, hip-hop, chill, instrumental",
        "mv": "chirp-v4",
        "make_instrumental": True
    }
)

task_id = response.json()["data"]["task_id"]
print(f"Task submitted: {task_id}")

# Step 2: Poll for completion
while True:
    status = requests.get(
        f"{BASE_URL}/suno/fetch/{task_id}",
        headers={"Authorization": f"Bearer {API_KEY}"}
    ).json()

    if status["data"]["status"] == "completed":
        for track in status["data"]["tracks"]:
            print(f"Track: {track['title']}")
            print(f"Audio URL: {track['audio_url']}")
            print(f"Duration: {track['duration']}s")
        break
    elif status["data"]["status"] == "failed":
        print("Generation failed:", status["data"]["error"])
        break

    time.sleep(10)  # Check every 10 seconds

# Generate a complete song with AI-written lyrics
response = requests.post(
    f"{BASE_URL}/suno/submit/music",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "prompt": "An upbeat pop song about a developer who finally fixed a production bug at 3am",
        "tags": "pop, upbeat, fun, electronic",
        "mv": "chirp-v4",
        "make_instrumental": False
    }
)

response = requests.post(
    f"{BASE_URL}/suno/submit/lyrics",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "prompt": "A rock ballad about the open source community"
    }
)

lyrics_data = response.json()
print(lyrics_data["data"]["text"])

custom_lyrics = """
[Verse 1]
Lines of code at midnight glow
Coffee cold but spirits high
Every bug a chance to grow
Every fix a battle cry

[Chorus]
We build the future line by line
Open source, the code is mine and yours
Together we design
A world that runs on what we pour

[Verse 2]
Pull requests at dawn arrive
Reviews sharp but always kind
In this repo we're alive
Leaving legacy behind
"""

response = requests.post(
    f"{BASE_URL}/suno/submit/music",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "prompt": custom_lyrics,
        "tags": "rock, ballad, anthemic, guitar",
        "mv": "chirp-v4",
        "make_instrumental": False
    }
)

curl -X POST https://api.crazyrouter.com/suno/submit/music \
  -H "Authorization: Bearer your-crazyrouter-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A jazzy instrumental with saxophone and soft drums",
    "tags": "jazz, saxophone, smooth, instrumental",
    "mv": "chirp-v4",
    "make_instrumental": true
  }'

def generate_background_music(video_mood, duration_hint):
    """Generate background music matching video mood."""
    mood_to_tags = {
        "happy": "upbeat, pop, cheerful, bright",
        "dramatic": "cinematic, orchestral, epic, intense",
        "chill": "lo-fi, ambient, relaxed, soft",
        "energetic": "electronic, EDM, fast, powerful"
    }

    response = requests.post(
        f"{BASE_URL}/suno/submit/music",
        headers={"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"},
        json={
            "prompt": f"A {video_mood} instrumental track, approximately {duration_hint}",
            "tags": mood_to_tags.get(video_mood, "ambient, background"),
            "make_instrumental": True
        }
    )
    return response.json()["data"]["task_id"]

# Generate battle music
battle_music = generate_music(
    prompt="Intense battle theme with fast drums and electric guitar",
    tags="game, battle, intense, fast, orchestral"
)

# Generate exploration music
explore_music = generate_music(
    prompt="Peaceful exploration theme with soft flute and ambient pads",
    tags="game, ambient, peaceful, exploration, fantasy"
)

jingle = generate_music(
    prompt="A short catchy jingle for a tech startup, modern and friendly, 15 seconds",
    tags="jingle, corporate, modern, short, catchy"
)