Suno

Generate, clone vocals, edit on a timeline, and export — one API for the full Suno workflow.

Suno is available as REST endpoints on https://api.mountsea.ai. Two call styles — do not mix them up:

Async — POST returns { "taskId": "..." }. Poll GET /suno/v2/status?taskId=... until success / failed / timeout.
Sync — the same HTTP response is the result. No taskId. Do not poll /status.

Core features

Generate Music

Create, extend, cover, mashup, stems, add_stems, replace_simple, and sound — 17 tasks. Fields and examples: Generate tasks.

Persona

Clip Persona (desensitized), or Voice Persona — Clone Voice (/voices, paid) or Init + Complete (free).

Inspiration

Build a real playlist, then generate with task=inspiration.

Studio

Song Editor — crop, fade, replace, and create sections on one clip.

Custom Models

Train on 6+ clips, then generate with chirp-custom:<uuid>.

Lyrics & Sound

Original lyrics, mashup lyrics, sync lyrics infill, Speech (is_speech on create), or Sounds via task=sound.

Export & Analysis

MP4 / WAV / M4A / MDI, lyrics timing, and downbeats.

Upload Session

Put multiple files on the same Suno account — required for Inspiration and some personas.

Models

Model	Notes
`chirp-v6`	Latest v6 Pro — recommended
`chirp-v6-mini`	v6 free tier
`chirp-v6-wild`	v6 wild
`chirp-v55` and older	Still accepted; always auto-converted to v6 Pro
`chirp-custom:<uuid>`	Your trained model — see Custom Model

Pick your path

First song

Call Generate Schema for task=create, then /generate and poll status.

Clone a voice

Clip Persona vs Voice Persona. Clone Voice (/voices, paid) and Init + Complete (free) are the same Voice Persona.

Edit an existing track

Prefer Studio batch edit for free timeline ops; billed only for Add Section / Replace.

Not sure about fields?

GET /suno/v2/generate/schema?task=xxx returns required fields and a copy-ready example.

How a call works

Check the schema

Generate Schema for generate task fields. For other endpoints, see the table below.

Call the endpoint

Async → { "taskId": "..." }. Sync → business JSON in the same response (no poll).

Poll only if you got a taskId

Get Task Status — GET /suno/v2/status?taskId=xxx.

Async vs Sync

Style	Response	Next step
Async	`{ "taskId" }`	Poll `/status`
Sync	Result body	Done. Do not poll `/status` (even if the server wrote an internal audit row)

Async (poll /status): /generate, /lyrics, /mashupLyrics, /concat, /remaster, /upload, /mp4, /mdi, /adjustSpeed, /voices, /voicePersona/init + /complete, /image/generate, /video/standalone/generate, /audio/crop /fade /reverse, all /studio/*, session item upload, customModel/upload + /create. Sync (immediate result): /generate/schema, /checkAccountOffline, /persona, /getVoxStem, /playlist/create + /addClips, /wav, /m4a, /timing, /downbeats, /upsampleTags, /lyricsInfill, /audio/upload/session (returns sessionId), /customModel/prepare (returns sessionId).

Export is mixed: /mp4 and /mdi are async; /wav and /m4a are sync and return download_url in the same response.

curl -X POST "https://api.mountsea.ai/suno/v2/generate" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "create",
    "model": "chirp-v6",
    "tags": "Pop, Happy, Upbeat",
    "prompt": "[Verse]\nHello world, here I come\n\n[Chorus]\nLa la la...",
    "title": "Summer Vibes"
  }'

curl -X GET "https://api.mountsea.ai/suno/v2/status?taskId=your-task-id" \
  -H "Authorization: Bearer your-api-key"

Endpoints

Core

Endpoint	Method	Description
`/suno/v2/generate`	POST	Unified generation — 17 task types
`/suno/v2/generate/schema`	GET	Parameter schema & examples per task
`/suno/v2/status`	GET	Poll by `taskId`
`/suno/v2/checkAccountOffline`	GET	Whether the task’s account is offline (sync)

Persona

Endpoint	Method	Description
`/suno/v2/persona`	POST	Clip persona — desensitized, sync
`/suno/v2/getVoxStem`	POST	Extract vocals for clip persona
`/suno/v2/voices`	POST	Clone Voice — paid one-step Voice Persona (async); `/generate` needs `persona_id` + `is_voice: true`
`/suno/v2/voicePersona/init`	POST	Free two-step — get phrase (`awaiting`)
`/suno/v2/voicePersona/complete`	POST	Free two-step — submit recording

See Persona overview for binding rules and is_voice.

Inspiration

Endpoint	Method	Description
`/suno/v2/playlist/create`	POST	Create playlist + bind account (sync)
`/suno/v2/playlist/addClips`	POST	Add clips (sync)

Image, video & clip edit

Endpoint	Method	Description
`/suno/v2/image/generate`	POST	Standalone image (async)
`/suno/v2/video/standalone/generate`	POST	Standalone video (async)
`/suno/v2/audio/crop`	POST	Crop (async, free)
`/suno/v2/audio/fade`	POST	Fade (async, free)
`/suno/v2/audio/reverse`	POST	Reverse (async)

Studio

Endpoint	Method	Description
`/suno/v2/studio/edit`	POST	Batch timeline ops (usually free)
`/suno/v2/studio/crop` … `/setSpeed`	POST	Single free ops
`/suno/v2/studio/addSection`	POST	Phase 1 — candidates (billed)
`/suno/v2/studio/addSectionCommit`	POST	Phase 2 — commit (usually free)
`/suno/v2/studio/replace`	POST	Replace a range (billed)

Lyrics, processing, export

Endpoint	Method	Description
`/suno/v2/lyrics`	POST	Generate lyrics
`/suno/v2/mashupLyrics`	POST	Mashup two songs’ lyrics
`/suno/v2/lyricsInfill`	POST	Fill one lyric span (sync)
`/suno/v2/concat`	POST	Concat clips
`/suno/v2/remaster`	POST	Remaster
`/suno/v2/adjustSpeed`	POST	Change speed
`/suno/v2/upsampleTags`	POST	Creative-boost tags (sync)
`/suno/v2/mp4` / `mdi`	POST	Export (async — poll `/status`)
`/suno/v2/wav` / `m4a`	POST	Export (sync — `download_url` in the response)
`/suno/v2/timing` / `downbeats`	POST	Analysis (sync)

Upload & custom model

Endpoint	Method	Description
`/suno/v2/upload`	POST	Single file (account may vary)
`/suno/v2/audio/upload/session`	POST	Same-account session (sync)
`/suno/v2/audio/upload/session/item`	POST	Upload one file in session
`/suno/v2/customModel/prepare`	POST	Create training session
`/suno/v2/customModel/upload`	POST	Upload training audio (min 6)
`/suno/v2/customModel/create`	POST	Submit training (100 credits)

Generate task types

Task	Description
`create`	New song — Custom (lyrics) or Simple (idea / `audio_refs` / pinned lyrics / `image_urls` / `video_url`)
`extend` / `upload_extend`	Continue a clip or uploaded file
`cover` / `upload_cover`	Cover a clip or uploaded file
`use_styles_lyrics`	Keep style, new lyrics
`replace_section`	Replace a range (you compute context)
`replace_simple`	Simple replace (`clip_id` + `range`; billed as `replace_section`)
`add_instrumental` / `add_vocals`	Add to a time range
`gen_stem_two` / `gen_stem_all`	Stem split
`add_stems`	Add stems to a clip (`stem_control_tags`, default `"add "`)
`mashup` / `sample`	Combine or sample
`inspiration`	From a real `playlist_id`
`sound`	Sounds — `description` required; optional `type` / `key` / `bpm`

Field sets differ per task. Use Generate Schema.

​Suno

​Core features

Generate Music

Persona

Inspiration

Studio

Custom Models

Lyrics & Sound

Export & Analysis

Upload Session

​Models

​Pick your path

First song

Clone a voice

Edit an existing track

Not sure about fields?

​How a call works

​Async vs Sync

​Endpoints

​Core

​Persona

​Inspiration

​Image, video & clip edit

​Studio

​Lyrics, processing, export

​Upload & custom model

​Generate task types

Suno

Core features

Models

Pick your path

How a call works

Async vs Sync

Endpoints

Core

Persona

Inspiration

Image, video & clip edit

Studio

Lyrics, processing, export

Upload & custom model

Generate task types