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

# 总览

> 每种 /generate 任务单独一页：必填字段和示例

# 生成任务

`POST /suno/v2/generate` 是一个接口、**17 种任务**。下面每种任务单独一页：做什么、哪些字段必填、以及可以直接复制的请求体。

全部是异步：响应是 `{ "taskId" }`，再轮询 [查询任务状态](/zh/api-reference/suno/task)。同一份数据的 JSON 在 [Generate Schema](/zh/api-reference/suno/generateSchema)（`GET /suno/v2/generate/schema?task=xxx`）。示例用 `chirp-v6`。`chirp-v50` 这类旧名字仍可传入，一律转到 v6 Pro。

Speech 不是单独的 `task`。它是 `task=create` 加上 `is_speech: true`，字段和写歌不同，所以单独一页。

| 任务 | 页面 |
| - | - |
| `create` | [创建](/zh/api-reference/suno/generateCreate) |
| Speech（`create` + `is_speech`） | [语音](/zh/api-reference/suno/generateSpeech) |
| `extend` | [延长](/zh/api-reference/suno/generateExtend) |
| `upload_extend` | [上传后延长](/zh/api-reference/suno/generateUploadExtend) |
| `cover` | [翻唱](/zh/api-reference/suno/generateCover) |
| `upload_cover` | [上传后翻唱](/zh/api-reference/suno/generateUploadCover) |
| `use_styles_lyrics` | [沿用风格与歌词](/zh/api-reference/suno/generateUseStylesLyrics) |
| `replace_section` | [替换片段](/zh/api-reference/suno/generateReplaceSection) |
| `replace_simple` | [简单替换](/zh/api-reference/suno/generateReplaceSimple) |
| `add_instrumental` | [加伴奏](/zh/api-reference/suno/generateAddInstrumental) |
| `add_vocals` | [加人声](/zh/api-reference/suno/generateAddVocals) |
| `gen_stem_two` | [两轨分离](/zh/api-reference/suno/generateStemTwo) |
| `gen_stem_all` | [全轨分离](/zh/api-reference/suno/generateStemAll) |
| `add_stems` | [加轨](/zh/api-reference/suno/generateAddStems) |
| `mashup` | [混搭](/zh/api-reference/suno/generateMashup) |
| `sample` | [采样](/zh/api-reference/suno/generateSample) |
| `inspiration` | [灵感任务](/zh/api-reference/suno/generateInspiration) |
| `sound` | [音效](/zh/api-reference/suno/generateSound) |

<span id="shared-optional-fields" />

## 共用可选字段

某个任务页没有单独说明时，还可以传：

| 字段 | 说明 |
| - | - |
| `title` | 歌名。`replace_simple` 不传则保留原曲 |
| `prompt` | 歌词或方向。`create` 非空即 Custom |
| `gpt_description_prompt` | 想法。`create` 在 `prompt` 为空时用来进入 Simple |
| `tags` / `negative_tags` | 风格，或要排除的风格。`sound` 会覆盖顶层 `tags` |
| `make_instrumental` | `true` = 无人声。默认 `false`。`gen_stem_two` 和 `gen_stem_all` 不传时服务端按 `true` 发送 |
| `vocal_gender` | `"m"` 或 `"f"`。不传 = 不指定 |
| `max_mode` | `true` = 双倍计费。`gen_stem_two`、`gen_stem_all`、`sound` 上 **HTTP 400** |
| `use_personalization` | 官方 My Taste。效果不保证 |
| `controls` | `style_weight` 0–1、`weirdness_constraint` 0–1、`aug_creativity` 0–4（`2` = Normal）、`audio_weight` 0–1、`duration` 10–360 秒（v55 / v6+） |

滑块说明：[创建选项](/zh/api-reference/suno/create-options)。接口总览：[生成音乐](/zh/api-reference/suno/generate)。


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