Suno API Explained: How to Generate Suno v6 Songs From Code (TTAPI Guide, Pricing and Free Quota)
A practical guide to generating Suno v6 songs from code with TTAPI's Suno Music API — generation, lyrics, extend, cover, stems and file delivery as pay-as-you-go REST calls from about $0.06 a song, with 30 free quota to start. What it covers, what it costs, a first request in curl, and how it fits alongside the Suno app and this downloader.

“Is there a Suno API?” comes up almost as often as “how do I download a Suno song?” — from developers who want a track generated on demand, and from creators who would rather script their workflow than click through the app. Suno’s own product is the website and the mobile apps, running on a credit balance tied to your plan; programmatic access comes through providers that put Suno’s models behind an ordinary REST interface. The one we have tested and link to from this site is TTAPI’s Suno Music API. This guide walks through what it can do, what it costs, how to make a first request, and how it relates to downloading songs.
Disclosure: this site is an independent download tool and is not affiliated with Suno, Inc. or TTAPI. We link to TTAPI because readers keep asking for a working Suno API; prices below are what TTAPI’s pricing page showed on the day of publication and may change.
What the Suno API actually is
TTAPI is an aggregator: one account, one balance, one key, and a catalogue of models (image, video, LLM and music) billed per use. Its Suno Music API wraps the current Suno generation — chirp-v6, chirp-v6-wild and chirp-v6-mini, the same three models we covered in Suno v6 explained — plus a long list of the editing tools Suno added with v6.
The core flow is asynchronous:
POST https://api.ttapi.io/suno/v1/musicwith your brief (or your own lyrics), the model and the output format.- The response gives you a job id.
GET /suno/v2/fetch(or ahookUrlwebhook) returns the finished track with a URL to the audio.
Everything else on the API is the same pattern with a different endpoint. The full list as of September 2026:
| Group | Endpoints |
|---|---|
| Generate | /music (inspiration or custom lyrics), /lyrics, /sounds (sound effects) |
| Continue and reinterpret | /extend, /cover, /upload-cover, /upload-extend, /upload, /inspo (1–4 reference audio URLs), /sample (sample to song), /mashup, /remaster |
| Arrange | /add-vocals, /add-instrumental, /add-stem, /replace-section, /remove-section, /crop, /fade-in, /fade-out, /adjust-speed, /concat |
| Separate and analyse | /stems (vocals / instrumental), /stems-all (full multitrack), /gen-midi, /alignedLyrics (word-level timing), /gen-bpm |
| Reuse | /create-voice, /persona, /create-model (train a private model from 6–24 public tracks) |
| Deliver | /download (mp3, m4a or wav), /generateVideo, /v2/fetch |
Two things stand out if you have used the Suno app. First, custom models: you can train a reusable model on a set of public tracks and then generate with mv: "chirp-custom:{model_id}". Second, stem separation and MIDI export are available as plain API calls, which on suno.com are tucked behind the editor.
What it costs
TTAPI meters everything in quota, where 1 quota ≈ $0.01, drawn from a single prepaid balance. There is no subscription and no minimum. The Suno rates on the pricing page at the time of writing:
| Operation | Quota | ≈ USD |
|---|---|---|
| Music generation (one task, two clips in the usual Suno way) | 6 | $0.06 |
| Extend, Cover, Upload cover/extend, Add vocals/instrumental/stem, Remaster, Mashup, Inspo, Sample, MIDI, Replace section | 6 each | $0.06 |
| Stem separation (vocals + instrumental) | 12 | $0.12 |
| All stems | 30 | $0.30 |
| Lyrics generation, Crop, Remove section, Fade in/out | 1 | $0.01 |
| Sound effects | 1.2 | $0.012 |
| Adjust speed | 3 | $0.03 |
| Upload audio | 0.5 | $0.005 |
| Create voice | 2 | $0.02 |
| Create model | 60 | $0.60 |
| File download (mp3 / m4a / wav) | 0.2 per request | $0.002 |
| Concat, Persona, Aligned lyrics, Video, BPM, tag upsampling | free | — |
max_mode: true |
2× the base price | — |
For comparison, Suno’s own plans work on credits: a Pro subscription is a fixed monthly fee for a fixed credit pool, and since September 2026 also a fixed number of downloads (7 lifetime on Free, 20 a month on Pro, 60 on Premier — see Suno’s download limits explained). The API is the opposite shape: no monthly fee, no download cap, a small charge per song and a tiny one per file fetch.
Free to try. A new TTAPI account starts with 30 quota free — five generations at the standard rate, or a lot of lyrics and edits — which is enough to wire up the flow and hear the output before you top up. TTAPI also runs time-limited promotions on the Suno API (when this article went live there was a 50%-off window ending September 14, 2026 at 15:00 UTC); the pricing page always shows the live rate.
A first request
You need a key from the TTAPI dashboard. Then, in inspiration mode (describe the song, let the model write lyrics):
curl --request POST \
--url https://api.ttapi.io/suno/v1/music \
--header 'TT-API-KEY: $TTAPI_KEY' \
--header 'Content-Type: application/json' \
--data '{
"custom": false,
"instrumental": false,
"mv": "chirp-v6",
"gpt_description_prompt": "slow cinematic electronic soul, 75 BPM, deep sub-bass, warm Rhodes piano, intimate low male vocal",
"audio_format": "mp3",
"variety": "normal",
"hookUrl": "https://example.com/webhooks/suno"
}'
Custom mode ("custom": true) is where you bring your own lyrics in prompt (up to 5,000 characters, with the same [Verse] / [Chorus] section tags Suno users write on the site), a title, and tags for genre, mood and vocal style — the same field that becomes the style tags you see under every song here. Optional knobs mirror v6’s editor: style_weight, weirdness_constraint, audio_weight, duration (10–360 s), vocal_gender, variety from off to max, a persona, or mv: "chirp-custom:{model_id}" for a model you trained.
Poll GET /suno/v2/fetch with the job id (or wait for the webhook) and you get the finished clips with audio URLs, then call /download once per file you want to keep — 0.2 quota each, and TTAPI recommends caching the returned URL rather than calling it again.
Who the API is for
- Developers building on top of Suno. Apps, bots, games, ad tools, anything that needs a song generated on demand without a human clicking Create. This is the only route to that today.
- Creators who hit the download wall. If your workflow is “generate a lot, keep the best”, Suno’s per-plan download caps are the bottleneck. Generating through the API, the audio is delivered as a file URL you can fetch for a fraction of a cent, with no monthly count.
- Producers who want stems and MIDI in a pipeline. Separate, export, drop into a DAW — as API calls, scriptable.
- Teams that want one bill. If you already use TTAPI for images or LLMs, Suno joins the same balance.
It is not for you if you make a few songs a month by hand and are happy in the Suno app; the credits you already pay for cover that. And it does not give you access to other people’s songs — the API generates new music from your prompts, it does not fetch tracks from suno.com.
How this relates to downloading Suno songs
People land on this site to save a song that already exists on suno.com — their own or a public one — as MP3, WAV, MP4 or the original file, from a public link and without touching Suno’s download allowance. The API is for the step before that: making the song in the first place, programmatically.
The two meet at the file. A song generated through TTAPI arrives as an mp3, m4a or wav URL, so you never need a downloader for it. A song made in the Suno app is on suno.com, where the official Download button is capped per plan; that is where a public-link tool like this one comes in. Whichever route you take, the rights question is the same and worth reading once: Is it legal to download Suno songs?
Things to know before you build
- Third-party, not official. TTAPI runs Suno’s models on your behalf; Suno itself offers no developer programme and has published no policy on aggregators. Treat it as you would any reseller: keep your own copies of what you generate.
- Rights follow the account that generated the song. Suno’s Terms grant commercial rights to paid-plan generations; how that maps onto API-generated tracks is TTAPI’s and Suno’s question, not something this site can answer. Ask TTAPI support before shipping API output commercially.
- Async by design. Generation takes tens of seconds; use the webhook rather than tight polling.
- Legacy endpoints are going away.
/v1/fetch,/v1/wavand/v1/voxare marked deprecated in favour of/v2/fetch,/downloadand/stems. Start on the new ones. - Prices move. Everything above is from September 2026; the live pricing page and your dashboard are the source of truth.
Frequently asked questions
Does Suno have an official API? No. As of September 2026 Suno offers no public developer API; the only official ways to generate are the website and the mobile apps. Third parties such as TTAPI provide API access to Suno’s models.
How much does the Suno API cost? On TTAPI, one music generation is 6 quota (about $0.06); stems 12; all stems 30; lyrics 1; a file download 0.2 quota. A new account gets 30 quota free. There is no subscription.
Which Suno models can I use through the API? The v6 family — chirp-v6, chirp-v6-wild and chirp-v6-mini — plus any private model you train with the create-model endpoint. Older model names are mapped to v6.
Can I download other people’s Suno songs with the API? No. The API generates new music from your prompts and returns files for those. To save a public song that already exists on suno.com, use a public-link tool such as this one.
Do API downloads count against Suno’s download limits? No. Suno’s 7/20/60 caps apply to the Download button on suno.com. API output is delivered by TTAPI as a file URL and is billed per request by TTAPI instead.
Next step
If you want to make songs from code, start at the TTAPI Suno Music API page, spend the 30 free quota on a few test generations, and read the request fields there. If you want to save a song that is already on suno.com, paste its link here — cover, lyrics and tags appear instantly, and the download is one click after signing in.


