> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mountsea.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

# 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

| Model                          | Description                                                                                 |
| ------------------------------ | ------------------------------------------------------------------------------------------- |
| `chirp-v55`                    | Latest model — best quality, recommended for all tasks                                      |
| `chirp-v50`                    | High-quality model, previous generation                                                     |
| `chirp-45+`                    | High-quality model with good performance                                                    |
| `chirp-v45` / `chirp-v45-lite` | Balanced quality and speed                                                                  |
| `chirp-v40` / `chirp-v35`      | Legacy models                                                                               |
| `chirp-custom:<uuid>`          | Custom models trained on your own audio via [Custom Model](/api-reference/suno/customModel) |

## Features at a Glance

<CardGroup cols={2}>
  <Card title="Music Generation" icon="music">
    Create, extend, cover, mashup, and sample music with 15 task types via a unified `/generate` endpoint
  </Card>

  <Card title="Lyrics & Sound" icon="pen-nib">
    Generate original lyrics, mashup lyrics from two songs, or create sound effects from text descriptions
  </Card>

  <Card title="Voice Persona" icon="microphone">
    Create verified voice personas from your own recordings with single-task two-phase voice verification
  </Card>

  <Card title="Custom Models" icon="brain">
    Train personalized music models on 6+ audio files and use them for generation
  </Card>

  <Card title="Audio Processing" icon="sliders">
    Remaster tracks, adjust speed, separate stems, concat clips, and enhance style tags
  </Card>

  <Card title="Export & Analysis" icon="download">
    Export to MP4/WAV/MDI, get lyrics timeline, and analyze downbeats
  </Card>

  <Card title="Inspiration" icon="lightbulb">
    Two-step playlist workflow — create playlist, then generate with `task=inspiration`
  </Card>

  <Card title="Image & Video" icon="image">
    Standalone image and video generation from text prompts
  </Card>

  <Card title="Clip Editing" icon="scissors">
    Free crop, fade, and reverse operations on existing clips
  </Card>

  <Card title="Studio Editing" icon="waveform" href="/api-reference/suno/studio">
    Song Editor — batch edit, Create Section, and Replace on a single clip
  </Card>

  <Card title="Batch Upload Session" icon="upload">
    Upload multiple files on one Suno account — for Inspiration, Persona, and more
  </Card>
</CardGroup>

## How to Use Suno

<Steps>
  <Step title="Check parameters for your task">
    Use the [Generate Schema](/api-reference/suno/generateSchema) endpoint to get the exact required/optional fields and a request example for your task type.
  </Step>

  <Step title="Create a task">
    Call the appropriate endpoint (e.g., [Generate](/api-reference/suno/generate)) with your parameters. You'll receive a `taskId`.
  </Step>

  <Step title="Poll task status">
    Use [Get Task Status](/api-reference/suno/task) (`GET /suno/v2/status?taskId=xxx`) to poll until `status` is `success`.
  </Step>

  <Step title="Use the results">
    The task result contains your generated audio clip data. You can then use it for further operations like export, remaster, etc.
  </Step>
</Steps>

## Quick Example

<CodeGroup>
  ```bash Create Music theme={null}
  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"
    }'
  ```

  ```bash Poll Task Status theme={null}
  curl -X GET "https://api.mountsea.ai/suno/v2/status?taskId=your-task-id" \
    -H "Authorization: Bearer your-api-key"
  ```
</CodeGroup>

<Tip>
  **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 →](/api-reference/suno/generateSchema)
</Tip>

***

## Available Endpoints

### Core Generation

| Endpoint                   | Method | Description                                          |
| -------------------------- | ------ | ---------------------------------------------------- |
| `/suno/v2/generate`        | POST   | Unified generation endpoint — supports 15 task types |
| `/suno/v2/generate/schema` | GET    | Get parameter schema & examples per task type        |
| `/suno/v2/status`          | GET    | Query task status by taskId                          |

### Inspiration (playlist)

| Endpoint                     | Method | Description                                   |
| ---------------------------- | ------ | --------------------------------------------- |
| `/suno/v2/playlist/create`   | POST   | Create playlist + bind account (sync)         |
| `/suno/v2/playlist/addClips` | POST   | Add more clips to an existing playlist (sync) |

### Image, video & clip editing

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

### Studio editing

| Endpoint                           | Method | Description                                        |
| ---------------------------------- | ------ | -------------------------------------------------- |
| `/suno/v2/studio/edit`             | POST   | Batch timeline ops in one export (usually free)    |
| `/suno/v2/studio/crop`             | POST   | Keep a range and export (free)                     |
| `/suno/v2/studio/removeSection`    | POST   | Delete ranges and export (free)                    |
| `/suno/v2/studio/duplicate`        | POST   | Copy a range and insert (free)                     |
| `/suno/v2/studio/reverse`          | POST   | Reverse range or whole song (free)                 |
| `/suno/v2/studio/fadeIn`           | POST   | Fade in (free)                                     |
| `/suno/v2/studio/fadeOut`          | POST   | Fade out (free)                                    |
| `/suno/v2/studio/setSpeed`         | POST   | Change speed rate (free)                           |
| `/suno/v2/studio/addSection`       | POST   | Phase 1 — generate candidate fills (billed)        |
| `/suno/v2/studio/addSectionCommit` | POST   | Phase 2 — commit selected candidate (usually free) |
| `/suno/v2/studio/replace`          | POST   | Replace a range (billed like `replace_section`)    |

### Lyrics

| Endpoint                | Method | Description                           |
| ----------------------- | ------ | ------------------------------------- |
| `/suno/v2/lyrics`       | POST   | Generate song lyrics from a prompt    |
| `/suno/v2/mashupLyrics` | POST   | Generate mashup lyrics from two songs |

### Audio Processing

| Endpoint                | Method | Description                            |
| ----------------------- | ------ | -------------------------------------- |
| `/suno/v2/concat`       | POST   | Concatenate audio clips                |
| `/suno/v2/remaster`     | POST   | Remaster audio with enhanced quality   |
| `/suno/v2/adjustSpeed`  | POST   | Adjust playback speed                  |
| `/suno/v2/upsampleTags` | POST   | Enhance style tags with creative boost |

### Export & Analysis

| Endpoint             | Method | Description                             |
| -------------------- | ------ | --------------------------------------- |
| `/suno/v2/mp4`       | POST   | Export audio as MP4 video               |
| `/suno/v2/wav`       | POST   | Export audio as WAV                     |
| `/suno/v2/mdi`       | POST   | Download MDI data (from gen\_stem\_all) |
| `/suno/v2/timing`    | POST   | Get lyrics & audio timeline             |
| `/suno/v2/downbeats` | POST   | Get downbeat positions                  |

### Upload & Persona

| Endpoint                             | Method | Description                                               |
| ------------------------------------ | ------ | --------------------------------------------------------- |
| `/suno/v2/upload`                    | POST   | Upload audio file to Suno (single file; account may vary) |
| `/suno/v2/audio/upload/session`      | POST   | Create batch upload session (sync, same account)          |
| `/suno/v2/audio/upload/session/item` | POST   | Upload one file in session (async)                        |
| `/suno/v2/persona`                   | POST   | Create a vocal persona                                    |
| `/suno/v2/getVoxStem`                | POST   | Extract vocal stem for persona creation                   |

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

| Endpoint                         | Method | Description                                                        |
| -------------------------------- | ------ | ------------------------------------------------------------------ |
| `/suno/v2/voicePersona/init`     | POST   | Upload voice audio & get verification phrase (status → `awaiting`) |
| `/suno/v2/voicePersona/complete` | POST   | Upload verification recording & create persona (same `taskId`)     |

### Custom Model (3-step model training)

| Endpoint                       | Method | Description                             |
| ------------------------------ | ------ | --------------------------------------- |
| `/suno/v2/customModel/prepare` | POST   | Create training session                 |
| `/suno/v2/customModel/upload`  | POST   | Upload training audio (min 6 files)     |
| `/suno/v2/customModel/create`  | POST   | Submit for model training (100 credits) |

***

## Explore the API Documentation

<AccordionGroup>
  <Accordion title="Core" icon="bolt" defaultOpen>
    * [Generate Music](generate) — Unified generation endpoint (15 task types)
    * [Generate Schema](generateSchema) — Get parameter schema per task type
    * [Get Task Status](task) — Poll task status
  </Accordion>

  <Accordion title="Inspiration" icon="lightbulb">
    * [Inspiration Guide](inspiration) — Playlist workflow (create → generate)
    * [Create Playlist](playlistCreate) — Step 1
    * [Add Clips to Playlist](playlistAddClips) — Optional Step 2
  </Accordion>

  <Accordion title="Image, Video & Editing" icon="image">
    * [Generate Image](imageGenerate) — Standalone images
    * [Generate Video](videoStandaloneGenerate) — Standalone video
    * [Crop Audio](audioCrop) — Trim clip
    * [Fade In/Out](audioFade) — Apply fades
    * [Reverse Audio](audioReverse) — Reverse clip
  </Accordion>

  <Accordion title="Studio" icon="waveform">
    * [Studio Guide](studio) — Song Editor overview & conventions
    * [Batch Edit](studioEdit) — Multi-op export (preferred)
    * [Crop](studioCrop) / [Remove](studioRemoveSection) / [Duplicate](studioDuplicate)
    * [Reverse](studioReverse) / [Fade In](studioFadeIn) / [Fade Out](studioFadeOut) / [Set Speed](studioSetSpeed)
    * [Add Section](studioAddSection) → [Commit](studioAddSectionCommit)
    * [Replace](studioReplace) — Regenerate a range
  </Accordion>

  <Accordion title="Lyrics" icon="pen-nib">
    * [Generate Lyrics](lyrics) — Create lyrics from a prompt
    * [Mashup Lyrics](mashupLyrics) — Combine lyrics from two songs
  </Accordion>

  <Accordion title="Audio Processing" icon="sliders">
    * [Concat Audio](concat) — Concatenate clips
    * [Remaster](remaster) — Enhance audio quality
    * [Adjust Speed](adjustSpeed) — Change playback speed
    * [Upsample Tags](upsampleTags) — Enhance style tags
  </Accordion>

  <Accordion title="Export & Analysis" icon="download">
    * [Export MP4](mp4) — Download as video
    * [Export WAV](wav) — Download lossless audio
    * [Download MDI](mdi) — Get MDI data
    * [Timeline](timing) — Lyrics & audio timeline
    * [Downbeats](downbeats) — Beat positions
  </Accordion>

  <Accordion title="Upload" icon="upload">
    * [Upload Audio](upload) — Single-file upload
    * [Batch Upload Session](uploadSession) — Same-account multi-file workflow
    * [Prepare Session](uploadSessionPrepare) — Step 1
    * [Upload Item](uploadSessionItem) — Step 2
  </Accordion>

  <Accordion title="Persona" icon="user">
    * [Create Persona](persona) — Create vocal persona from clip
    * [Get Vox Stem](getVoxStem) — Extract vocals from clip
  </Accordion>

  <Accordion title="Voice Persona" icon="microphone">
    * [Voice Persona Guide](voicePersona) — Full workflow guide (single taskId, two phases)
    * [Init](voicePersonaInit) — Upload voice & get verification phrase
    * [Complete](voicePersonaComplete) — Upload verification & create persona
  </Accordion>

  <Accordion title="Custom Model" icon="brain">
    * [Custom Model Guide](customModel) — Full 3-step workflow guide
    * [Prepare](customModelPrepare) — Create training session
    * [Upload](customModelUpload) — Upload training audio
    * [Create](customModelCreate) — Submit for training
  </Accordion>
</AccordionGroup>

***

## Generate Task Types

The `/suno/v2/generate` endpoint supports 15 task types through a single unified interface:

| Task                | Description                                                           |
| ------------------- | --------------------------------------------------------------------- |
| `create`            | Create new music from scratch                                         |
| `extend`            | Extend existing music from a position                                 |
| `upload_extend`     | Extend uploaded external audio                                        |
| `upload_cover`      | Cover uploaded external audio                                         |
| `cover`             | Create cover of existing clip                                         |
| `use_styles_lyrics` | Use styles from clip with new lyrics                                  |
| `replace_section`   | Replace a section of existing audio                                   |
| `add_instrumental`  | Add instrumental to a time range                                      |
| `add_vocals`        | Add vocals to a time range                                            |
| `gen_stem_two`      | Separate into vocals + instrumental                                   |
| `gen_stem_all`      | Separate into all stems                                               |
| `mashup`            | Mashup two songs together                                             |
| `sample`            | Sample from an existing clip                                          |
| `inspiration`       | Generate from a real playlist (`playlist_id` from `/playlist/create`) |
| `sound`             | Generate sound effects                                                |

<Info>
  Each task requires different parameters. Use [Generate Schema](/api-reference/suno/generateSchema) to get the exact fields for each task type.
</Info>