Skip to main content

​
Introduction to Suno Music Generation

Welcome to the Suno Music Generation service documentation! This service integrates Suno AI to provide a comprehensive suite of music generation, editing, and audio processing tools. From creating original tracks to training your own custom models, Suno enables powerful end-to-end music workflows.

​
Supported Models

ModelDescription
chirp-v55Latest model — best quality, recommended for all tasks
chirp-v50High-quality model, previous generation
chirp-45+High-quality model with good performance
chirp-v45 / chirp-v45-liteBalanced quality and speed
chirp-v40 / chirp-v35Legacy models
chirp-custom:<uuid>Custom models trained on your own audio via Custom Model

​
Features at a Glance

Music Generation

Create, extend, cover, mashup, and sample music with 15 task types via a unified /generate endpoint

Lyrics & Sound

Generate original lyrics, mashup lyrics from two songs, or create sound effects from text descriptions

Voice Persona

Create verified voice personas from your own recordings with single-task two-phase voice verification

Custom Models

Train personalized music models on 6+ audio files and use them for generation

Audio Processing

Remaster tracks, adjust speed, separate stems, concat clips, and enhance style tags

Export & Analysis

Export to MP4/WAV/MDI, get lyrics timeline, and analyze downbeats

Inspiration

Two-step playlist workflow — create playlist, then generate with task=inspiration

Image & Video

Standalone image and video generation from text prompts

Clip Editing

Free crop and fade operations on existing clips

Batch Upload Session

Upload multiple files on one Suno account — for Inspiration, Persona, and more

​
How to Use Suno

1

Check parameters for your task

Use the Generate Schema endpoint to get the exact required/optional fields and a request example for your task type.
2

Create a task

Call the appropriate endpoint (e.g., Generate) with your parameters. You’ll receive a taskId.
3

Poll task status

Use Get Task Status (GET /suno/v2/status?taskId=xxx) to poll until status is success.
4

Use the results

The task result contains your generated audio clip data. You can then use it for further operations like export, remaster, etc.

​
Quick Example

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-v50",
    "tags": "Pop, Happy, Upbeat",
    "prompt": "[Verse]\nHello world, here I come\n\n[Chorus]\nLa la la...",
    "title": "Summer Vibes"
  }'
Not sure which parameters to pass? Call GET /suno/v2/generate/schema?task=your_task first — it returns the required fields, optional fields, and a complete request example for each task type.Try Generate Schema →

​
Available Endpoints

​
Core Generation

EndpointMethodDescription
/suno/v2/generatePOSTUnified generation endpoint — supports 15 task types
/suno/v2/generate/schemaGETGet parameter schema & examples per task type
/suno/v2/statusGETQuery task status by taskId

​
Inspiration (playlist)

EndpointMethodDescription
/suno/v2/playlist/createPOSTCreate playlist + bind account (sync)

​
Image, video & clip editing

EndpointMethodDescription
/suno/v2/image/generatePOSTStandalone image generation (async)
/suno/v2/video/standalone/generatePOSTStandalone video generation (async)
/suno/v2/audio/cropPOSTCrop clip (async, free)
/suno/v2/audio/fadePOSTFade in/out (async, free)

​
Lyrics

EndpointMethodDescription
/suno/v2/lyricsPOSTGenerate song lyrics from a prompt
/suno/v2/mashupLyricsPOSTGenerate mashup lyrics from two songs

​
Audio Processing

EndpointMethodDescription
/suno/v2/concatPOSTConcatenate audio clips
/suno/v2/remasterPOSTRemaster audio with enhanced quality
/suno/v2/adjustSpeedPOSTAdjust playback speed
/suno/v2/upsampleTagsPOSTEnhance style tags with creative boost

​
Export & Analysis

EndpointMethodDescription
/suno/v2/mp4POSTExport audio as MP4 video
/suno/v2/wavPOSTExport audio as WAV
/suno/v2/mdiPOSTDownload MDI data (from gen_stem_all)
/suno/v2/timingPOSTGet lyrics & audio timeline
/suno/v2/downbeatsPOSTGet downbeat positions

​
Upload & Persona

EndpointMethodDescription
/suno/v2/uploadPOSTUpload audio file to Suno (single file; account may vary)
/suno/v2/audio/upload/sessionPOSTCreate batch upload session (sync, same account)
/suno/v2/audio/upload/session/itemPOSTUpload one file in session (async)
/suno/v2/personaPOSTCreate a vocal persona
/suno/v2/getVoxStemPOSTExtract vocal stem for persona creation

​
Voice Persona (single-task, two-phase voice verification)

EndpointMethodDescription
/suno/v2/voicePersona/initPOSTUpload voice audio & get verification phrase (status → awaiting)
/suno/v2/voicePersona/completePOSTUpload verification recording & create persona (same taskId)

​
Custom Model (3-step model training)

EndpointMethodDescription
/suno/v2/customModel/preparePOSTCreate training session
/suno/v2/customModel/uploadPOSTUpload training audio (min 6 files)
/suno/v2/customModel/createPOSTSubmit for model training (100 credits)

​
Explore the API Documentation

Core

  • Voice Persona Guide — Full workflow guide (single taskId, two phases)
  • Init — Upload voice & get verification phrase
  • Complete — Upload verification & create persona

​
Generate Task Types

The /suno/v2/generate endpoint supports 15 task types through a single unified interface:
TaskDescription
createCreate new music from scratch
extendExtend existing music from a position
upload_extendExtend uploaded external audio
upload_coverCover uploaded external audio
coverCreate cover of existing clip
use_styles_lyricsUse styles from clip with new lyrics
replace_sectionReplace a section of existing audio
add_instrumentalAdd instrumental to a time range
add_vocalsAdd vocals to a time range
gen_stem_twoSeparate into vocals + instrumental
gen_stem_allSeparate into all stems
mashupMashup two songs together
sampleSample from an existing clip
inspirationGenerate from a real playlist (playlist_id from /playlist/create)
soundGenerate sound effects
Each task requires different parameters. Use Generate Schema to get the exact fields for each task type.