Suno API for Developers: Generate AI Music with sunor
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
| Task | Credits | What it does |
|---|---|---|
music | 10 | Generate a complete song |
lyrics | 5 | Generate lyrics from a description |
upload | 1 | Upload an audio file by URL |
concat | 5 | Concatenate 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
- Try it without code: Head to the Playground to generate music in your browser
- Read the docs: Full API reference at docs.sunor.cc
- 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.