Suno V5.5 API is now available
sunor
← Back to blog

Suno API for Developers: Generate AI Music with sunor

sunoapitutorialai-music

Suno has become the most popular AI music generator in the world — over 100 million users, 7 million tracks generated daily, and songs that have charted on Billboard. But if you're a developer who wants to build with it, you'll quickly hit a wall: Suno has no official API.

That's the problem sunor solves. We provide a clean, reliable REST API for Suno V5, so you can generate AI music programmatically without managing accounts, handling CAPTCHAs, or reverse-engineering browser sessions.

What is Suno?

Suno is an AI music generation platform that creates complete songs — vocals, instrumentals, lyrics, and all — from text prompts. It launched in 2023 and has grown rapidly, raising $250M at a $2.45B valuation.

Suno V5 (released September 2025) is the model this post focuses on. V5.5 (released March 2026) builds on it with voice cloning, custom models, and ~40% better prompt accuracy — see Suno V5.5: What's New and How to Use the Suno API for the deep dive. Key V5 capabilities (still apply in V5.5):

  • Text-to-music: Describe what you want in natural language and get a full song
  • Custom lyrics: Write your own lyrics with structure tags like [Verse], [Chorus], [Bridge]
  • Instrumental mode: Generate tracks without vocals
  • 1,200+ genre styles: From pop to orchestral to genre mashups like "midwest emo + neosoul"
  • Up to 8-minute songs with coherent structure and natural transitions
  • Realistic vocals: Emotion-rich delivery with breath control and vibrato — a major leap from earlier versions

The audio quality in V5 is close to release-ready. Generation takes 15–30 seconds for most tracks.

Why developers need an API

Suno's web app is great for creating individual songs. But if you're building a product — a video editor that auto-generates soundtracks, a game with dynamic music, a social app with AI-powered creation tools — you need programmatic access.

The problem: Suno only offers beta API access to select partners. There is no self-service API key, no public documentation, no SDK.

Third-party solutions exist (open-source browser automation, account pool proxies), but they come with reliability issues: CAPTCHA challenges, session management, rate limits, and unclear legal standing.

What is sunor?

sunor is a Sound & Music Aggregated API Platform. We handle the infrastructure so you can focus on building.

  • Simple REST API: Create a task, poll for the result. Two endpoints.
  • Suno V5 access: Latest model, all features — music generation, lyrics, audio upload, clip concatenation.
  • Pay-as-you-go credits: No subscriptions. Buy credits, use them when you need them.
  • Reliable: We manage uptime, retries, and queue processing. Failed tasks get automatic credit refunds.

Quick start

1. Create a song

curl -X POST https://sunor.cc/api/v1/task \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk_live_YOUR_API_KEY" \
  -d '{
    "model": "suno",
    "task_type": "music",
    "input": {
      "gpt_description_prompt": "A chill lo-fi hip-hop beat with jazz piano and vinyl crackle",
      "make_instrumental": true
    }
  }'
const response = await fetch("https://sunor.cc/api/v1/task", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "sk_live_YOUR_API_KEY",
  },
  body: JSON.stringify({
    model: "suno",
    task_type: "music",
    input: {
      gpt_description_prompt: "A chill lo-fi hip-hop beat with jazz piano and vinyl crackle",
      make_instrumental: true,
    },
  }),
});
 
const { data } = await response.json();
console.log("Task ID:", data.task_id);
import requests
 
response = requests.post(
    "https://sunor.cc/api/v1/task",
    headers={"x-api-key": "sk_live_YOUR_API_KEY"},
    json={
        "model": "suno",
        "task_type": "music",
        "input": {
            "gpt_description_prompt": "A chill lo-fi hip-hop beat with jazz piano and vinyl crackle",
            "make_instrumental": True,
        },
    },
)
 
data = response.json()["data"]
print("Task ID:", data["task_id"])

2. Poll for the result

curl https://sunor.cc/api/v1/task/YOUR_TASK_ID \
  -H "x-api-key: sk_live_YOUR_API_KEY"
const result = await fetch(`https://sunor.cc/api/v1/task/${taskId}`, {
  headers: { "x-api-key": "sk_live_YOUR_API_KEY" },
});
 
const { data } = await result.json();
 
if (data.status === "success") {
  console.log("Audio URL:", data.output.result[0].audio_url);
}
import requests
 
response = requests.get(
    f"https://sunor.cc/api/v1/task/{task_id}",
    headers={"x-api-key": "sk_live_YOUR_API_KEY"},
)
 
data = response.json()["data"]
 
if data["status"] == "success":
    print("Audio URL:", data["output"]["result"][0]["audio_url"])

That's it. Two API calls to go from a text prompt to a generated song.

Want to try it without writing code? Head to the Playground — paste a prompt, pick a model, and hear the result in your browser.

Music generation modes

sunor supports three ways to create music:

Inspiration mode — describe what you want, Suno handles the rest:

{
  "model": "suno",
  "task_type": "music",
  "input": {
    "gpt_description_prompt": "An upbeat indie pop song with jangly guitars",
    "make_instrumental": false
  }
}

Custom mode — provide your own lyrics and style tags:

{
  "model": "suno",
  "task_type": "music",
  "input": {
    "prompt": "[Verse]\nWalking down the sunlit road\nFeeling light without a load\n\n[Chorus]\nOh summer days, carry me away",
    "tags": "pop, acoustic, upbeat",
    "title": "Summer Days"
  }
}

Continuation mode — extend an existing clip:

{
  "model": "suno",
  "task_type": "music",
  "input": {
    "continue_clip_id": "previous-clip-id",
    "continue_at": 30,
    "prompt": "[Bridge]\nBut tonight we let it go"
  }
}

Task types and credits

TaskCreditsWhat it does
music10Generate a complete song
lyrics5Generate lyrics from a description
upload1Upload an audio file by URL
concat5Concatenate clips together

Hear what's possible

We curate the best AI-generated music from across the internet on our Songreel page — tracks from YouTube, Bilibili, and TikTok that showcase what Suno V5 can do across genres. From gospel to dark country to contemporary classical, the range is impressive.

Get started

  1. Try it without code: Head to the Playground to generate music in your browser
  2. Read the docs: Full API reference at docs.sunor.cc
  3. Get an API key: Sign up and create a key from your Dashboard

For deeper dives, see How to Get a Suno API Key — Step-by-Step Guide, Suno API Pricing in 2026, and Suno API vs Udio API: A Developer's Comparison.

We're building sunor to be the simplest way to add AI music to your applications. If you have questions or feature requests, reach out through our live chat.


Last updated: 2026-06-04.