Music● Pricing pendingSuno

Suno Music API

Create songs, shape performances, and work with your own sound.

Generate Suno music, extend or cover an existing song, prepare a Voice, and export audio through one task API. Availability is shown in the studio. Listening examples remain clearly labeled synthetic samples.

Per task: 1 execution item
Native tracks: 2
Audio sample: Synthetic preview
Availability: Pricing pending

FEATURED · DEMOPublic sample

Neon after hours

Synthetic demo audio · not an AI-generated song

City Pop, synth, warm bass

0:00 / —

Generate music

Describe the piece and supply a style or references. Custom mode lets you write the lyrics yourself.

Operation guide ↗

Create

Checking availability…

ModelRequiredSuno version: V6, V6_MINI or V6_WILD. Extension must match the generated source model.Custom modeRequired

Custom mode uses title, lyrics and style. Simple mode uses a prompt plus reference attachments.InstrumentalRequiredGenerate instrumental music. Instrumental extensions omit prompt, lyrics and vocal_gender.Persona modelOptionalstyle_persona or voice_persona; must match the resource's actual origin.TitleRequired · ≤ 80Title. Generate/cover: up to 80 characters; extend and other operations: up to 100. Required for custom generation.StyleOptional · ≤ 1000Musical style, up to 1000 characters. Counts as one attachment in simple generation.PromptOptional · ≤ 5000Simple mode: description up to 3000 characters, used alongside lyrics. Custom mode: fallback lyrics up to 5000 characters, used only when lyrics is omitted.LyricsOptional · ≤ 5000Up to 5000 characters. Custom mode uses this instead of prompt when present; simple mode uses it alongside prompt and counts non-empty lyrics as one attachment.

Advanced parameters

Negative tagsOptional · ≤ 1000Styles to exclude; required for adding instrumental backing or vocals.Vocal genderOptionalm or f. A vocal tendency, not a guaranteed voice identity. When generating music, requires custom mode.Style weightOptionalStyle influence, 0–1 with at most two decimal places. When generating music, requires custom mode.Weirdness constraintOptionalCreativity constraint, 0–1 with at most two decimal places. When generating music, requires custom mode.Audio weightOptionalAudio influence, 0–1 with at most two decimal places. Generation requires custom, non-instrumental mode.VarietyOptionalVariety: integer 0–4, default 1 in custom generation.Persona IDOptional · ≤ 200APIstable Voice or Persona ID; provider root and artist mapping remain server-side.Max modeOptionalPayAPI extension. Max mode may increase supplier cost. APIstable credit deduction is currently disabled.DurationOptionalRequested duration, 10–360 seconds; custom generation only. Omit for automatic duration.

1 execution item → 2 native songs

Billing is not enabled. No credits are reserved or deducted.

This operation has not been enabled on the server. You can inspect all parameters and request examples.

Uploads: 24 hours · Generated files: 14 days · Task logs: 30 days

Output

Your results will appear here

Listen to the returned songs, read their lyrics, or choose one for another operation.

Billing is not enabled. No credits are reserved or deducted.

Stopping the browser poll does not cancel the task.

Uploads: 24 hours · Generated files: 14 days · Task logs: 30 days

/ Listen

Tracks · Listen

All listening samples use the same synthetic clip. Descriptions are example creative briefs, not evidence of the model’s musical output.

Neon after hours

City Pop, synth, warm bass

Synthetic demo audio · not an AI-generated song

Rainy study room

Lo-fi, piano, ambient

Synthetic demo audio · not an AI-generated song

Summer corner store

Folk, acoustic guitar, warm

Synthetic demo audio · not an AI-generated song

Before daybreak

Cinematic, strings, gradual build

Synthetic demo audio · not an AI-generated song

/ Capabilities

Create · Capabilities

Generate and edit

V6, V6 Mini and V6 Wild with lyrics, style, advanced controls and reference URLs.

Availability shown in studio

Cover and extend

Use an APIstable audio_id. Complete songs are assembled before delivery.

Availability shown in studio

Voice and Persona

Upload, choose a verification language, record the phrase, create and check a Voice. Create Personas from eligible songs.

Availability shown in studio

Export and stems

WAV, MP3, MIDI and vocal separation use the same task protocol.

Availability shown in studio

/ Pricing

Pricing pending

Billing is not enabled. No credits are reserved or deducted.

Uploads: 24 hours · Generated files: 14 days · Task logs: 30 days

Native pairs do not increase the execution-item count.

Specification	Billing unit	USD	Credits
Pricing pending	per task	$0.00	0

1 execution item → 2 native songsBilling is not enabled. No credits are reserved or deducted.

Pricing →

Billing is not enabled. No credits are reserved or deducted.

/ API

Take your music request into code.

Create and query every async operation through the task API. result is an object.

Song description / Lyrics
1 execution item → 2 native songs
Task ID → Output

Full API reference →
Output →

{
  "model": "suno_generate",
  "input": {
    "lyrics": "[Verse]\nWe fold a map into a boat\nAnd let the morning carry it home",
    "style": "Fingerpicked guitar, gentle brushed drums",
    "max_mode": false,
    "model": "V6",
    "custom_mode": true,
    "instrumental": false,
    "title": "Paper boats at dawn"
  }
}

Create and query every async operation through the task API. result is an object.

/ Models

Explore music workflows.

Select Suno operations in the studio above. Other music models remain previews.

Music model	Tracks	Specification	Song description	Credits	Full API reference
Suno Music	2	Pricing pending	Create music through the unified task API. Billing is not enabled.	0 / per task	Suno Music ↗
Cadence Music 1	2	Pricing pending	Turn a feeling into two original tracks.	100 / per task	Cadence Music 1 ↗
Cadence Extend	2	Pricing pending	Let the good part keep going.	60 / per task	Cadence Extend ↗

/ FAQ

Suno Music · FAQ

Do two songs cost two execution items?

No. One request creates one execution item, normally with two native songs. Music credit deduction is currently disabled.

How long are files available?

Uploads last 24 hours and generated files last 14 days. Task details are retained for 30 days. Save downloads before they expire.

Can I cover or extend an external URL?

Cover and extend accept only an APIstable audio_id. First register a URL with suno_upload, then use its returned audio_id.

How do I create a Voice?

Submit suno_voice_upload, request a verification phrase in your language, record that phrase and submit suno_voice_create, then check availability.

Can I retrieve aligned lyrics?

suno_lyrics_timestamps returns the provider alignment object. The player does not invent timing when alignment is unavailable.

SUNO API

Write the first line. Let it take it from here.

Billing is not enabled. No credits are reserved or deducted.

Create music task View API

Use only audio and lyrics you have permission to use. Commercial rights depend on the model and source material.

Suno Music API

Neon after hours

Generate music

Create

Output

Tracks · Listen

Neon after hours

Rainy study room

Summer corner store

Before daybreak

Create · Capabilities

Generate and edit

Cover and extend

Voice and Persona

Export and stems

Pricing pending

Take your music request into code.

Explore music workflows.

Suno Music · FAQ

Related models

Cadence Music 1

Cadence Extend

Reel Video 2

Nova Chat 4

Nova Chat 4 Mini

Write the first line. Let it take it from here.