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

# Suno 工作流指南

> 动作之间怎么串，以及全部能力的清单

Suno 的能力是可以串起来的：生成一首歌之后，可以接着写长、换风格、拆音轨、导出成别的格式。这些动作有先后依赖，本文把常用的几条路走一遍。

还没生成过第一首歌的话，先看 [快速上手](https://docs.rixapi.com/docs/cn/guides/suno-quickstart.md)。

## 做一首完整的歌

一次生成出来的歌通常只有两三分钟。想要更长的，用续写接龙，最后拼成整曲。

**1. 生成开头**

调 `suno/music`，拿到 `music_id`。

**2. 接着往下写**

调 `suno/extend`，传上一步的 `music_id` 和 `continue_at`（从第几秒接）。

续写产生的是**片段**，不是完整曲目，时长通常只有几十秒。想更长就拿新片段再续一次。

**3. 拼成整曲**

调 `suno/concat`，传**续写片段的 music\_id**。系统会顺着这个片段把整条续写链拼成完整曲目。

**4. 导出**

调 `suno/download`，选 mp3、m4a 或 wav。

> [!WARNING]
>
> 拼接时要填**续写产生的片段 ID**，不是最初那首歌的 ID。直接传没续写过的曲子会返回 400，提示该任务无法拼接。

## 改编你已有的音频

手里有一段音频，想让它变成另一种风格，或者接着往下写。

**1. 上传**

调 `suno/upload`，传一个公网可直接下载的音频地址，拿到 `music_id`。

这个接口是**同步**的，会等处理完才返回，通常要一分钟左右，记得把客户端超时放宽。

**2. 改编或续写**

* 换风格：`suno/upload-cover`
* 接着写：`suno/upload-extend`

这两个动作也可以跳过上传直接用，传 `audio_url` 即可，系统内部会先把音频准备好。

想让新歌带上某段音频的感觉，但不是翻唱它，用 `suno/inspo`，最多可以给四段参考。

## 拿到伴奏或人声

**1. 分离**

`suno/stems` 默认取出主人声，也可以指定其他乐器轨。想一次拆出全部音轨用 `suno/stems-all`。

**2. 重新配**

* 有了人声想配新伴奏：`suno/add-instrumental`
* 有了伴奏想配新演唱：`suno/add-vocals`
* 想再叠一条乐器：`suno/add-stem`

## 让不同的歌用同一个嗓音

**1. 取得音色**

* 从已有曲目提取：`suno/persona`
* 从一段音频克隆：`suno/create-voice`

两者都会返回一个音色 ID。

**2. 用这个音色创作**

生成时带上 `persona_id`，新歌就会用这个嗓音演唱。仅自定义模式有效。

想要的不只是嗓音而是整体风格，用 `suno/create-model`，拿 6 到 24 段音频训练一个专属模型。训练较慢，完成后会得到一个模型 ID。

## 成品的后期处理

歌做好之后，整体调快或调慢用 `suno/adjust-speed`（可以选择保持音高），转成 MIDI 用 `suno/gen-midi`，要逐句的歌词时间轴（附带整首的波形数据）用 `suno/aligned-lyrics`。

## 要等多久

所有动作的提交响应都是同一个形状：返回任务 ID，再用 `GET /suno/v2/fetch/{task_id}` 取结果，或者提交时带 `notify_hook` 等推送。写一套代码就够，不用按动作分支。

区别只在要等多久。下面这些**通常提交完就已经是终态**，紧接着查一次就能拿到结果：

`suno/upload`、`suno/persona`、`suno/gen-midi`、`suno/aligned-lyrics`、`suno/upsample-tags`

其中 MIDI 和歌词时间轴偶尔要多等一会儿，这时任务显示为进行中，稍后再查即可，只计费一次。

> [!NOTE]
>
> 这几个里 `suno/upload` 的提交请求本身最慢，实测接近一分钟才返回，客户端超时要留够，其余都很快。

## 全部能力

### 生成新曲

| 动作 | 能做什么 | 必填 |
| - | - | - |
| `suno/music` | 用一句话描述，或自己写歌词，生成完整歌曲，一次出两首 | — |
| `suno/lyrics` | 根据主题生成歌词，一次给两份候选 | `prompt` |
| `suno/sounds` | 生成单次音效或可循环音效，可指定节拍与调性 | `sound` |
| `suno/inspo` | 以一到四段音频作为风格参考来创作 | `audio_urls` |
| `suno/sample` | 截取一段采样，以它为素材生成新曲 | `music_id` |
| `suno/mashup` | 把两首曲目融合成一首新作 | `mashup_music_id` |

### 改已有的曲子

| 动作 | 能做什么 | 必填 |
| - | - | - |
| `suno/extend` | 从指定秒数继续写下去，风格与原曲保持一致 | `continue_at`、`music_id` |
| `suno/cover` | 保留旋律骨架，换一种风格重新演绎 | `music_id` |
| `suno/remaster` | 在保持原曲结构的前提下重新制作 | `music_id` |
| `suno/replace-section` | 只重写指定的时间区间，其余部分保持不变 | `infill_end_s`、`infill_start_s`、`music_id` |
| `suno/add-vocals` | 给纯伴奏加上人声演唱 | `music_id` |
| `suno/add-instrumental` | 给人声轨配上完整伴奏 | `music_id` |
| `suno/add-stem` | 在现有曲目上再加一条乐器轨 | `music_id` |

### 用你自己的音频

| 动作 | 能做什么 | 必填 |
| - | - | - |
| `suno/upload` | 上传音频以供其他动作引用 | `audio_url` |
| `suno/upload-cover` | 上传你自己的音频，换一种风格重新演绎 | `audio_url` |
| `suno/upload-extend` | 上传你自己的音频，从指定位置接着写 | `audio_url`、`continue_at` |

### 拆分与重组

| 动作 | 能做什么 | 必填 |
| - | - | - |
| `suno/stems` | 从成曲里分离出主人声，或指定某一条乐器轨 | `music_id` |
| `suno/stems-all` | 一次拆出全部乐器与人声分轨 | `music_id` |
| `suno/concat` | 把续写产生的多段合并为完整曲目 | `music_id` |

### 调整

| 动作 | 能做什么 | 必填 |
| - | - | - |
| `suno/adjust-speed` | 调整播放速度，可选择是否保持音高 | `music_id`、`title` |

### 导出

| 动作 | 能做什么 | 必填 |
| - | - | - |
| `suno/download` | 导出 mp3、m4a 或 wav | `formats`、`music_id` |
| `suno/gen-midi` | 把曲目转换成 MIDI | `music_id` |

### 音色与模型

| 动作 | 能做什么 | 必填 |
| - | - | - |
| `suno/persona` | 从一首曲目提取音色，供后续创作复用 | `music_id`、`name` |
| `suno/create-voice` | 用一段音频克隆出可复用的音色 | `audio_url` |
| `suno/create-model` | 用 6 到 24 段音频训练属于你的风格模型 | `audio_urls`、`name` |

### 分析

| 动作 | 能做什么 | 必填 |
| - | - | - |
| `suno/aligned-lyrics` | 取歌词逐句的时间轴与整首的波形数据，可用于逐句高亮和绘制音轨图 | `music_id` |
| `suno/upsample-tags` | 把几个简短标签扩写成详细的风格描述 | `tags` |

## 关于计费

按次计费，与生成时长、返回条数无关。几点值得知道：

* 一次返回多条结果的动作，如果部分失败，**按实际成功的条数折算**
* 开启 `max_mode` 价格翻倍，它只在自定义模式下有效
* 任务失败会退还本次费用
* 歌词时间轴（`suno/aligned-lyrics`）不收费

各动作的具体单价见模型详情页。

## 常见问题

> [accordion] 拼接为什么提示无法拼接？
>
> `suno/concat` 的 `music_id` 要填续写产生的片段 ID。如果传的是最初生成的那首歌，它没有可拼接的后续片段，会返回 400。

> [accordion] 上传音频一直超时？
>
> `suno/upload` 是同步接口，实测单次接近一分钟。请把客户端超时放宽到 90 秒以上。另外音频地址必须是公网可直接下载的，不能是需要登录的页面。

> [accordion] 一次生成的两首歌可以都要吗？
>
> 可以。`musics` 数组里的每一条都是完整可用的成品，各自有独立的 `music_id`，都能继续续写或分轨。

> [accordion] 模型版本该怎么选？
>
> 三个版本价格相同。`chirp-v6` 均衡，`chirp-v6-wild` 风格更奔放，`chirp-v6-mini` 出结果更快。不填默认 `chirp-v6`。只有生成类动作接受这个参数，其余动作与版本无关。


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