Suno V5.5 API is now available
sunor
Powered by Suno V5.5

Suno API for Developers

Unofficial REST API for Suno AI music generation. Simple authentication, pay-as-you-go pricing, no Suno account required.

25 free credits on signup — no credit card required.

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.

1

Create an account

Go to sunor.cc/login and sign in with Google. No email forms, no waitlist.

2

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.

3

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"
  }
}
See pricing for personalized song workflow

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
  }
}
Compare PAYG vs subscription pricing

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"
  }
}
See pricing for production volume

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"
  }
}
Sample tag patterns in docs

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>"
  }
}
Custom Mode reference

Code Examples

Generate a song with a single API call. All examples use the same endpoint and authentication.

curl
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
    }
  }'
Python
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"])
JavaScript
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 TypeCreditsPrice (USD)
Music Generation10$0.10
Lyrics Generation5$0.05
Audio Upload1$0.01
Concat / Extend5$0.05
Free to start
25 free credits on every new account. No credit card required.
Auto-refunds
Failed generations are automatically refunded. You only pay for successful output.
No subscription
Top up when you need to. Minimum $5 (500 credits). No recurring charges.

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.

ProviderPer-call priceFree tierPricing modelNotable
sunor.cc$0.10 / song (10 credits)25 credits, no cardPAYG, $5 minimumBoth 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 / runPAYG, no expirationpay-as-you-goCheapest 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 tiers4 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 documentedcredit-basedOpenAI-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-basedvariescredit packsMarketed as ~30% below Suno's official rate; multi-model — but specific tier rates not publicly listed.
sunoapi.org †$19 – $199/monthnonesubscription onlySubscription-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.

Looking for Udio? sunor also supports the Udio model with the same API — pass "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.