What is the Suno API?
Suno does not offer a public API. There is no developer console on suno.com, no API key page, and no official way to generate music programmatically.
Sunor provides an unofficial Suno AI API — a REST wrapper around Suno's music generation models. You get standard API access with key-based authentication, async task processing, and automatic billing. No Suno account needed.
The API currently runs Suno V5.5 (the latest model) with support for music generation, lyrics generation, audio upload, and song extension.
How to Use the Suno API
Get from zero to generating music in three steps.
Create an account
Go to sunor.cc/login and sign in with Google. No email forms, no waitlist.
Get your API key
In your dashboard, go to API Keys and create a new key. Copy it immediately — the key (format: sk_live_...) is shown only once. For a detailed walkthrough, see How to Get a Suno API Key.
Make your first API call
Send a POST request to create a music generation task. Poll for the result. When the status is "success", download your audio.
Real Customers Building With Sunor
These workflows account for the majority of traffic on sunor today. Each one targets a different developer use case for the Suno API.
Personalized Song Platforms
Build B2C marketplaces where customers commission custom songs as gifts and event keepsakes — birthdays, anniversaries, weddings, Mother's Day, retirement celebrations, memorial dedications. Suno V5's Custom Mode embeds user-supplied details (recipient name, story, occasion, language — V5 supports 35+) directly into the lyrics; voice tags shape the vocal style. Auto-refund on failure means you can quote customers a fixed price per song with predictable margins.
{
"model": "suno",
"task_type": "music",
"input": {
"prompt": "[Female Voice]\n[Verse 1]\nHappy birthday, dear Anna,\n50 years of stories shared...\n[Chorus]\nYou're the light of our family...",
"tags": "pop, joyful, acoustic"
}
}Marketing & Brand Audio
Agencies and brand teams generating jingles, sonic identity assets, ad music, and social campaign tracks. Fast iteration without licensing fees or session musician scheduling. PAYG credits scale with project volume — no monthly subscription to absorb during slow months, no quota to plan around during a launch sprint.
{
"model": "suno",
"task_type": "music",
"input": {
"gpt_description_prompt": "Energetic 30-second jingle for a sneaker brand, electronic synth, motivational",
"make_instrumental": true
}
}Video & Multimedia Tools
Add custom-generated soundtracks to video editors, vlog tools, social media content platforms, and stock-footage workflows. The make_instrumental flag produces vocals-free background music suitable for voice-over content; tag-driven style control ('cinematic, ambient' or 'upbeat, electronic') makes per-scene music generation feasible without licensing a music library.
{
"model": "suno",
"task_type": "music",
"input": {
"gpt_description_prompt": "Cinematic ambient pad for a 30-second product reveal — slow build, hopeful, no vocals",
"make_instrumental": true,
"tags": "cinematic, ambient, hopeful"
}
}Game Development & Interactive Media
Generate dynamic OST, ambient layers, and modular tracks for games, interactive experiences, and game-audio middleware. Instrumental mode + tag-driven mood control supports level-by-level or area-by-area scoring. Pre-generate a music library at build time, or call the API at runtime for player-state-driven music.
{
"model": "suno",
"task_type": "music",
"input": {
"gpt_description_prompt": "Looping dungeon exploration ambient — low strings, distant percussion, tense but explorable",
"make_instrumental": true,
"tags": "fantasy ost, ambient, looping"
}
}AI Agent Workflows & Creator Tools
Plug Sunor into AI agent pipelines and songwriter tools where lyrics are authored elsewhere — by an LLM, a user-facing lyric editor, or an autonomous music agent. Custom Mode accepts the lyrics directly with [Verse], [Chorus], [Bridge] section markers and generates audio that follows the structure. The API design matches programmatic music as part of a larger flow, not as a one-off generation.
{
"model": "suno",
"task_type": "music",
"input": {
"prompt": "[Verse 1]\n<LLM-generated lyrics here>\n[Pre-Chorus]\n<more lyrics>\n[Chorus]\n<hook lyrics>",
"tags": "<genre, mood, style>"
}
}Code Examples
Generate a song with a single API call. All examples use the same endpoint and authentication.
curl -X POST https://sunor.cc/api/v1/task \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno",
"task_type": "music",
"input": {
"gpt_description_prompt": "An upbeat acoustic folk song about road trips",
"make_instrumental": false
}
}'import requests, time
API_KEY = "YOUR_API_KEY"
headers = {"x-api-key": API_KEY, "Content-Type": "application/json"}
# Create task
task = requests.post("https://sunor.cc/api/v1/task", headers=headers, json={
"model": "suno",
"task_type": "music",
"input": {"gpt_description_prompt": "An upbeat acoustic folk song about road trips"}
}).json()
# Poll until done
task_id = task["data"]["task_id"]
while True:
result = requests.get(f"https://sunor.cc/api/v1/task/{task_id}", headers=headers).json()
if result["data"]["status"] in ("success", "failure"):
break
time.sleep(5)
print(result["data"]["output"])const API_KEY = "YOUR_API_KEY";
const headers = { "x-api-key": API_KEY, "Content-Type": "application/json" };
// Create task
const task = await fetch("https://sunor.cc/api/v1/task", {
method: "POST",
headers,
body: JSON.stringify({
model: "suno",
task_type: "music",
input: { gpt_description_prompt: "An upbeat acoustic folk song about road trips" },
}),
}).then((r) => r.json());
// Poll until done
const taskId = task.data.task_id;
let result;
while (true) {
result = await fetch(`https://sunor.cc/api/v1/task/${taskId}`, { headers }).then((r) => r.json());
if (["success", "failure"].includes(result.data.status)) break;
await new Promise((r) => setTimeout(r, 5000));
}
console.log(result.data.output);Production Patterns
Polling with timeout + backoff
Most music tasks complete in 3–7 minutes. Poll every 5 seconds for the first minute, then every 10 seconds. Treat anything still pending after 15 minutes as a soft failure and surface a retry option to the user. Sunor has a built-in safety timeout as a final fallback — your client doesn't need to track one itself.
Refund-aware error handling
Failed tasks auto-refund credits to your wallet within seconds. Your client should treat a refund-eligible failure as 'no charge incurred, safe to retry with adjusted prompt' rather than 'budget consumed.' Check status === 'failure' or 'timeout' and re-submit with backoff.
Rate limit + concurrency
Default 120 requests/minute per API key. For high-volume workloads, batch your status checks and use a single in-flight queue per key. Sustained higher throughput is available — contact us via Telegram or email for a custom limit.
Webhooks vs polling
Sunor doesn't currently offer webhook callbacks — polling is the supported pattern. For 100+ concurrent tasks, a single background worker polling every 10 seconds with batched status reads is more efficient than per-task polling. Subscribe to product updates for webhook availability.
Full API reference at docs.sunor.cc
How Much Does the Suno API Cost?
Pay-as-you-go pricing. No subscription, no monthly fees. 1 credit = $0.01 USD.
| Task Type | Credits | Price (USD) |
|---|---|---|
| Music Generation | 10 | $0.10 |
| Lyrics Generation | 5 | $0.05 |
| Audio Upload | 1 | $0.01 |
| Concat / Extend | 5 | $0.05 |
Full pricing details at sunor.cc/pricing
How Sunor Compares to Other Suno API Providers
Six active Suno API providers in 2026 — sunor.cc listed first as the publisher of this comparison, the other five sorted by per-call price ascending.
| Provider | Per-call price | Free tier | Pricing model | Notable |
|---|---|---|---|---|
| sunor.cc | $0.10 / song (10 credits) | 25 credits, no card | PAYG, $5 minimum | Both Suno and Udio under one REST API. PAYG with a low $5 minimum top-up. Google OAuth signup, no credit card on free tier. |
| APIPASS † | ~$0.014 / run | PAYG, no expiration | pay-as-you-go | Cheapest per-call; watermark-free — but no official SDKs (their own design choice), and price sustainability is unclear. |
| apiframe.ai | ~$0.07 (Basic plan, $19/mo) | 300 credits/month, no card | $0 / $19 / $99 / $199 / $2,499 tiers | 4 official SDKs (Node/Python/PHP/Go) + multi-model (Suno + Udio + Midjourney + Flux) — but tiered subscription from $19/mo, not PAYG. |
| evolink.ai | $0.111 / song (8 credits) | none documented | credit-based | OpenAI-compatible base URL (swap-in for existing clients); 120+ models with automatic fallback — but the priciest per-call; no documented free tier. |
| kie.ai † | credit-based | varies | credit packs | Marketed as ~30% below Suno's official rate; multi-model — but specific tier rates not publicly listed. |
| sunoapi.org † | $19 – $199/month | none | subscription only | Subscription-only with fixed monthly credit allocation — Suno only (no Udio); V5 access limited per their docs. |
† Pricing data sourced from third-party listicles; their public pricing pages weren't directly accessible at fact-check time (2026-06-05). Verify current rates on each provider's own site before committing.
"model": "udio" in your task request.Start building with the Suno API
Get your API key, generate your first song, and ship AI music in your product.
Sunor is an unofficial Suno API wrapper — not affiliated with, endorsed by, or officially connected to Suno Inc.