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

# Suno 音乐生成服务介绍

欢迎使用 **Suno 音乐生成**服务文档！

本服务集成了 **Suno AI**，提供全面的音乐生成、编辑和音频处理工具套件。从创作原创曲目到训练您自己的定制模型，Suno 支持强大的端到端音乐工作流程。

## 支持的模型

| 模型                             | 描述                                                          |
| ------------------------------ | ----------------------------------------------------------- |
| `chirp-v55`                    | 最新模型 — 最佳质量，推荐用于所有任务                                        |
| `chirp-v50`                    | 高质量模型，上一代                                                   |
| `chirp-45+`                    | 高质量模型，性能优良                                                  |
| `chirp-v45` / `chirp-v45-lite` | 质量与速度均衡                                                     |
| `chirp-v40` / `chirp-v35`      | 旧版模型                                                        |
| `chirp-custom:<uuid>`          | 通过[定制模型](/zh/api-reference/suno/customModel)基于您自己的音频训练的定制模型 |

## 功能一览

<CardGroup cols={2}>
  <Card title="音乐生成" icon="music">
    通过统一的 `/generate` 端点，使用 15 种任务类型来创建、延伸、翻唱、混搭和采样音乐
  </Card>

  <Card title="歌词与音效" icon="pen-nib">
    生成原创歌词、将两首歌曲的歌词进行混搭，或根据文本描述创建音效
  </Card>

  <Card title="声音角色" icon="microphone">
    通过单任务两阶段语音验证，从您自己的录音中创建经过验证的声音角色
  </Card>

  <Card title="定制模型" icon="brain">
    基于 6 个以上音频文件训练个性化音乐模型，并用于生成
  </Card>

  <Card title="音频处理" icon="sliders">
    重制曲目、调整速度、分离音轨、拼接片段，以及增强风格标签
  </Card>

  <Card title="导出与分析" icon="download">
    导出为 MP4/WAV/MDI 格式，获取歌词时间线，分析节拍位置
  </Card>

  <Card title="Inspiration 灵感" icon="lightbulb">
    两步播放列表流程 — 创建播放列表后使用 `task=inspiration` 生成
  </Card>

  <Card title="图片与视频" icon="image">
    根据文本提示词独立生成图片与视频
  </Card>

  <Card title="片段编辑" icon="scissors">
    对已有 clip 免费裁剪与淡入淡出
  </Card>

  <Card title="批量上传 Session" icon="upload">
    多个文件上传到同一 Suno 账号 — 适用于 Inspiration、Persona 等
  </Card>
</CardGroup>

## 如何使用 Suno

<Steps>
  <Step title="检查您任务所需的参数">
    使用 [Generate Schema](/zh/api-reference/suno/generateSchema) 端点获取您任务类型所需的精确必填/可选字段和请求示例。
  </Step>

  <Step title="创建任务">
    调用相应的端点（例如 [Generate](/zh/api-reference/suno/generate)）并传入您的参数。您将收到一个 `taskId`。
  </Step>

  <Step title="轮询任务状态">
    使用 [获取任务状态](/zh/api-reference/suno/task)（`GET /suno/v2/status?taskId=xxx`）进行轮询，直到 `status` 为 `success`。
  </Step>

  <Step title="使用结果">
    任务结果包含您生成的音频片段数据。您可以将其用于后续操作，如导出、重制等。
  </Step>
</Steps>

## 快速示例

<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>
  **不确定该传哪些参数？** 先调用 `GET /suno/v2/generate/schema?task=your_task` — 它会返回每种任务类型的必填字段、可选字段和完整的请求示例。

  [试用 Generate Schema →](/zh/api-reference/suno/generateSchema)
</Tip>

***

## 可用端点

### 核心生成

| 端点                         | 方法   | 描述                   |
| -------------------------- | ---- | -------------------- |
| `/suno/v2/generate`        | POST | 统一生成端点 — 支持 15 种任务类型 |
| `/suno/v2/generate/schema` | GET  | 获取每种任务类型的参数模式和示例     |
| `/suno/v2/status`          | GET  | 通过 taskId 查询任务状态     |

### Inspiration（播放列表）

| 端点                         | 方法   | 描述              |
| -------------------------- | ---- | --------------- |
| `/suno/v2/playlist/create` | POST | 创建播放列表并绑定账号（同步） |

### 图片、视频与片段编辑

| 端点                                   | 方法   | 描述             |
| ------------------------------------ | ---- | -------------- |
| `/suno/v2/image/generate`            | POST | 独立图片生成（异步）     |
| `/suno/v2/video/standalone/generate` | POST | 独立视频生成（异步）     |
| `/suno/v2/audio/crop`                | POST | 裁剪 clip（异步，免费） |
| `/suno/v2/audio/fade`                | POST | 淡入淡出（异步，免费）    |

### 歌词

| 端点                      | 方法   | 描述             |
| ----------------------- | ---- | -------------- |
| `/suno/v2/lyrics`       | POST | 根据提示词生成歌词      |
| `/suno/v2/mashupLyrics` | POST | 将两首歌曲的歌词进行混搭生成 |

### 音频处理

| 端点                      | 方法   | 描述        |
| ----------------------- | ---- | --------- |
| `/suno/v2/concat`       | POST | 拼接音频片段    |
| `/suno/v2/remaster`     | POST | 以增强质量重制音频 |
| `/suno/v2/adjustSpeed`  | POST | 调整播放速度    |
| `/suno/v2/upsampleTags` | POST | 创意增强风格标签  |

### 导出与分析

| 端点                   | 方法   | 描述                           |
| -------------------- | ---- | ---------------------------- |
| `/suno/v2/mp4`       | POST | 将音频导出为 MP4 视频                |
| `/suno/v2/wav`       | POST | 将音频导出为 WAV                   |
| `/suno/v2/mdi`       | POST | 下载 MDI 数据（来自 gen\_stem\_all） |
| `/suno/v2/timing`    | POST | 获取歌词与音频时间线                   |
| `/suno/v2/downbeats` | POST | 获取节拍位置                       |

### 上传与角色

| 端点                                   | 方法   | 描述                     |
| ------------------------------------ | ---- | ---------------------- |
| `/suno/v2/upload`                    | POST | 上传音频（单文件；账号可能不同）       |
| `/suno/v2/audio/upload/session`      | POST | 创建批量上传 Session（同步，同账号） |
| `/suno/v2/audio/upload/session/item` | POST | Session 内上传单个文件（异步）    |
| `/suno/v2/persona`                   | POST | 创建声音角色                 |
| `/suno/v2/getVoxStem`                | POST | 提取人声音轨用于角色创建           |

### Voice Persona（单任务、两阶段语音验证）

| 端点                               | 方法   | 描述                             |
| -------------------------------- | ---- | ------------------------------ |
| `/suno/v2/voicePersona/init`     | POST | 上传语音音频并获取验证短语（状态 → `awaiting`） |
| `/suno/v2/voicePersona/complete` | POST | 上传验证录音并创建角色（使用相同 `taskId`）     |

### Custom Model（三步模型训练）

| 端点                             | 方法   | 描述               |
| ------------------------------ | ---- | ---------------- |
| `/suno/v2/customModel/prepare` | POST | 创建训练会话           |
| `/suno/v2/customModel/upload`  | POST | 上传训练音频（至少 6 个文件） |
| `/suno/v2/customModel/create`  | POST | 提交模型训练（100 积分）   |

***

## 浏览 API 文档

<AccordionGroup>
  <Accordion title="核心" icon="bolt" defaultOpen>
    * [生成音乐](generate) — 统一生成端点（15 种任务类型）
    * [生成参数模式](generateSchema) — 获取每种任务类型的参数模式
    * [获取任务状态](task) — 轮询任务状态
  </Accordion>

  <Accordion title="Inspiration" icon="lightbulb">
    * [Inspiration 指南](inspiration) — 播放列表流程（创建 → 生成）
    * [创建播放列表](playlistCreate) — 第 1 步
  </Accordion>

  <Accordion title="图片、视频与编辑" icon="image">
    * [图片生成](imageGenerate) — 独立图片
    * [视频生成](videoStandaloneGenerate) — 独立视频
    * [音频裁剪](audioCrop) — 裁剪 clip
    * [淡入淡出](audioFade) — 应用淡入淡出
  </Accordion>

  <Accordion title="歌词" icon="pen-nib">
    * [生成歌词](lyrics) — 根据提示词创建歌词
    * [混搭歌词](mashupLyrics) — 将两首歌曲的歌词进行混搭
  </Accordion>

  <Accordion title="音频处理" icon="sliders">
    * [拼接音频](concat) — 拼接片段
    * [重制](remaster) — 增强音频质量
    * [调整速度](adjustSpeed) — 更改播放速度
    * [增强标签](upsampleTags) — 增强风格标签
  </Accordion>

  <Accordion title="导出与分析" icon="download">
    * [导出 MP4](mp4) — 下载为视频
    * [导出 WAV](wav) — 下载无损音频
    * [下载 MDI](mdi) — 获取 MDI 数据
    * [时间线](timing) — 歌词与音频时间线
    * [节拍](downbeats) — 节拍位置
  </Accordion>

  <Accordion title="上传" icon="upload">
    * [上传音频](upload) — 单文件上传
    * [批量上传 Session](uploadSession) — 同账号多文件流程
    * [准备 Session](uploadSessionPrepare) — 第 1 步
    * [上传 Item](uploadSessionItem) — 第 2 步
  </Accordion>

  <Accordion title="角色" icon="user">
    * [创建角色](persona) — 从片段创建声音角色
    * [获取人声音轨](getVoxStem) — 从片段中提取人声
  </Accordion>

  <Accordion title="Voice Persona" icon="microphone">
    * [Voice Persona 指南](voicePersona) — 完整工作流程指南（单个 taskId，两个阶段）
    * [初始化](voicePersonaInit) — 上传语音并获取验证短语
    * [完成](voicePersonaComplete) — 上传验证录音并创建角色
  </Accordion>

  <Accordion title="Custom Model" icon="brain">
    * [Custom Model 指南](customModel) — 完整的三步工作流程指南
    * [准备](customModelPrepare) — 创建训练会话
    * [上传](customModelUpload) — 上传训练音频
    * [创建](customModelCreate) — 提交训练
  </Accordion>
</AccordionGroup>

***

## 生成任务类型

`/suno/v2/generate` 端点通过单一统一接口支持 15 种任务类型：

| 任务                  | 描述                                              |
| ------------------- | ----------------------------------------------- |
| `create`            | 从零开始创建新音乐                                       |
| `extend`            | 从指定位置延伸已有音乐                                     |
| `upload_extend`     | 延伸已上传的外部音频                                      |
| `upload_cover`      | 翻唱已上传的外部音频                                      |
| `cover`             | 翻唱已有片段                                          |
| `use_styles_lyrics` | 使用片段的风格搭配新歌词                                    |
| `replace_section`   | 替换已有音频的某个段落                                     |
| `add_instrumental`  | 为指定时间范围添加伴奏                                     |
| `add_vocals`        | 为指定时间范围添加人声                                     |
| `gen_stem_two`      | 分离为人声 + 伴奏                                      |
| `gen_stem_all`      | 分离为所有音轨                                         |
| `mashup`            | 将两首歌曲混搭                                         |
| `sample`            | 从已有片段中采样                                        |
| `inspiration`       | 基于真实播放列表生成（`playlist_id` 来自 `/playlist/create`） |
| `sound`             | 生成音效                                            |

<Info>
  每种任务需要不同的参数。请使用 [Generate Schema](/zh/api-reference/suno/generateSchema) 获取每种任务类型的精确字段说明。
</Info>