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. Most calls are async: POST returns a taskId, then poll GET /suno/v2/status.

Core features

Generate Music

Create, extend, cover, mashup, stems, add_stems, and sound — 16 tasks on one /generate endpoint. Optional Create Options (Max Mode, Variety, …).

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, or text-to-SFX 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 the exact fields of your task.

Create a task

Most endpoints return { "taskId": "..." }. Clip Persona (/persona) and playlist create are synchronous.

Poll until success

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

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 — 16 task types
`/suno/v2/generate/schema`	GET	Parameter schema & examples per task
`/suno/v2/status`	GET	Poll by `taskId`

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 Voice Persona (same result as Init+Complete)
`/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/concat`	POST	Concat clips
`/suno/v2/remaster`	POST	Remaster
`/suno/v2/adjustSpeed`	POST	Change speed
`/suno/v2/upsampleTags`	POST	Creative-boost tags
`/suno/v2/mp4` / `wav` / `m4a` / `mdi`	POST	Export
`/suno/v2/timing` / `downbeats`	POST	Analysis

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
`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
`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`	Sound effects

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

​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

Endpoints

Core

Persona

Inspiration

Image, video & clip edit

Studio

Lyrics, processing, export

Upload & custom model

Generate task types