> ## 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.

# Overview

> One page per /generate task — required fields and examples

# Generate tasks

`POST /suno/v2/generate` is one endpoint and **17 tasks**. Each task has its own page below: what it does, which fields are required, and a body you can copy.

All of them are async: the response is `{ "taskId" }`, then poll [Get Task Status](/api-reference/suno/task). The same data as JSON is [Generate Schema](/api-reference/suno/generateSchema) (`GET /suno/v2/generate/schema?task=xxx`). Examples use `chirp-v6`. Older names such as `chirp-v50` still work and always convert to v6 Pro.

Speech is not a separate `task`. It is `task=create` with `is_speech: true`, documented on its own page because the fields differ from a song.

| Task | Page |
| - | - |
| `create` | [Create](/api-reference/suno/generateCreate) |
| Speech (`create` + `is_speech`) | [Speech](/api-reference/suno/generateSpeech) |
| `extend` | [Extend](/api-reference/suno/generateExtend) |
| `upload_extend` | [Upload extend](/api-reference/suno/generateUploadExtend) |
| `cover` | [Cover](/api-reference/suno/generateCover) |
| `upload_cover` | [Upload cover](/api-reference/suno/generateUploadCover) |
| `use_styles_lyrics` | [Use styles & lyrics](/api-reference/suno/generateUseStylesLyrics) |
| `replace_section` | [Replace section](/api-reference/suno/generateReplaceSection) |
| `replace_simple` | [Simple replace](/api-reference/suno/generateReplaceSimple) |
| `add_instrumental` | [Add instrumental](/api-reference/suno/generateAddInstrumental) |
| `add_vocals` | [Add vocals](/api-reference/suno/generateAddVocals) |
| `gen_stem_two` | [Two stems](/api-reference/suno/generateStemTwo) |
| `gen_stem_all` | [All stems](/api-reference/suno/generateStemAll) |
| `add_stems` | [Add stems](/api-reference/suno/generateAddStems) |
| `mashup` | [Mashup](/api-reference/suno/generateMashup) |
| `sample` | [Sample](/api-reference/suno/generateSample) |
| `inspiration` | [Inspiration task](/api-reference/suno/generateInspiration) |
| `sound` | [Sounds](/api-reference/suno/generateSound) |

## Shared optional fields

Unless a task page says otherwise, you may also send:

| Field | Notes |
| - | - |
| `title` | Song title. On `replace_simple`, omit to keep the original |
| `prompt` | Lyrics or direction. On `create`, a non-empty value selects Custom |
| `gpt_description_prompt` | Idea text. On `create`, helps enter Simple when `prompt` is empty |
| `tags` / `negative_tags` | Style, or styles to exclude. On `sound`, top-level `tags` are overwritten |
| `make_instrumental` | `true` = no vocals. Default `false`. On `gen_stem_two` and `gen_stem_all`, omit means the server sends `true` |
| `vocal_gender` | `"m"` or `"f"`. Omit = no preference |
| `max_mode` | `true` = 2× billing. **HTTP 400** on `gen_stem_two`, `gen_stem_all`, and `sound` |
| `use_personalization` | Official My Taste. Effect is not guaranteed |
| `controls` | `style_weight` 0–1, `weirdness_constraint` 0–1, `aug_creativity` 0–4 (`2` = Normal), `audio_weight` 0–1, `duration` 10–360s (v55 / v6+) |

Sliders: [Create Options](/api-reference/suno/create-options). Endpoint overview: [Generate Music](/api-reference/suno/generate).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.