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

# Suno 音乐生成

> Suno AI 音乐生成与编辑接口总览,任务生命周期与定价

<Note>
  **国内用户请注意：** 中国大陆用户请使用 `https://toapis.cn` 作为接口地址（Base URL）。文档示例中的 `https://toapis.com` 请替换为 `https://toapis.cn`。
</Note>

Suno 音乐系列提供从生成、续写、剪辑、分轨到分析的完整 AI 音乐工作流。所有操作共用一个提交入口，通过 URL 路径中的 `{operation}` 区分：

```
POST https://toapis.com/v1/music/generations/{operation}
```

所有操作均为**异步任务**：提交后返回任务 ID，通过任务查询接口轮询结果。返回的音频、封面、视频等媒体 URL 均为本站 CDN 持久化地址，可长期访问。

## Authorizations

<ParamField header="Authorization" type="string" required>
  使用 Bearer Token 进行认证

  获取 API Key：访问 [API Key 管理页面](https://toapis.com/console/token)

  ```
  Authorization: Bearer YOUR_API_KEY
  ```
</ParamField>

## 通用说明

* 请求体中的 `model` 固定为 `"suno"`
* 涉及已有作品的操作传 `task_id`（本平台任务 ID,`tsk_aud_` 前缀），部分操作再搭配 `audio_index` 指定曲目序号
* `custom` 控制模式：为 `true` 时 `prompt` 按**自定义歌词**处理，`title`/`style`/`negative_tags` 生效；为 `false`（或不传）时为灵感模式，`prompt`/`gpt_description` 按一段音乐描述处理
* `max_mode` 为高质量档位，价格为普通档两倍，仅对支持的操作生效（见下表 **Max** 列），且其中带 `custom` 的操作要求 effective custom 为 `true`

## 操作与定价

### 生成类

| operation | 说明 | 价格 | Max |
| - | - | - | - |
| `generation` | 音乐生成（默认操作） | \$0.05 / 次 | \$0.10 |
| `lyrics` | 歌词生成 | \$0.008 | - |
| `inspo` | 参考音频灵感生成 | \$0.068 | \$0.136 |
| `sounds` | 音效生成 | \$0.0096 | - |
| `upsampleTags` | 风格标签扩写 | \$0.004 | - |

### 上传类

| operation | 说明 | 价格 | Max |
| - | - | - | - |
| `uploadTask` | 上传音频登记为任务 | \$0.004 | - |
| `uploadCover` | 上传音频并翻唱 | \$0.05 | \$0.10 |
| `uploadExtend` | 上传音频并续写 | \$0.05 | \$0.10 |

### 续写与改造类

| operation | 说明 | 价格 | Max |
| - | - | - | - |
| `extend` | 从指定时间点续写 | \$0.05 | \$0.10 |
| `coverSong` | 换风格翻唱 | \$0.05 | \$0.10 |
| `remaster` | 音质重制 | \$0.05 | - |
| `mashup` | 两首歌混编 | \$0.05 | \$0.10 |
| `replaceMusic` | 片段换写 | \$0.05 | \$0.10 |
| `sample` | 采样重编排（源需为上传产物） | \$0.05 | \$0.10 |

### 分轨类

| operation | 说明 | 价格 |
| - | - | - |
| `stems` | 人声 / 伴奏分轨 | \$0.10 |
| `stemsAll` | 全乐器分轨 | \$0.24 |
| `addStem` | 新增一条乐器轨 | $0.05（Max $0.10) |
| `addVocals` | 为上传素材加人声（源需为上传产物） | $0.05（Max $0.10) |
| `addInstrumental` | 为上传素材加伴奏（源需为上传产物） | $0.05（Max $0.10) |

### 剪辑类

| operation | 说明 | 价格 |
| - | - | - |
| `crop` | 截取时间段 | \$0.008 |
| `removeSection` | 删除时间段 | \$0.008 |
| `fadeIn` | 开头淡入 | \$0.008 |
| `fadeOut` | 结尾淡出 | \$0.008 |
| `adjustSpeed` | 变速（可选保调） | \$0.024 |
| `concat` | 拼接续写分段 | \$0.004 |

### 分析与导出类

| operation | 说明 | 价格 |
| - | - | - |
| `midi` | 音频转 MIDI 音符数据 | \$0.05 |
| `bpm` | BPM 分析 | \$0.0008 |
| `alignedLyrics` | 歌词时间轴对齐 | \$0.0008 |
| `download` | 多格式下载（mp3/m4a/wav) | \$0.0016 |
| `generateMp4` | 歌词视频包装 | \$0.004 |
| `wav` | 下载 WAV（旧版，建议用 `download`) | \$0.0016 |

### 资产类（高级）

| operation | 说明 | 价格 |
| - | - | - |
| `persona` | 提取人声角色 | \$0.004 |
| `createVoice` | 克隆声音（需干净人声源） | \$0.016 |
| `vox` | 人声提取（旧版，建议用 `persona`) | \$0.004 |
| `createModel` | 自定义模型训练（6-24 条音频） | \$0.96 |

## 任务生命周期

```
提交 → queued / in_progress → completed / failed
```

* 任务失败时预扣费用自动退还
* `download`/`midi`/`bpm`/`alignedLyrics` 等结果返回结构化数据，详见 [任务状态查询](/docs/cn/api-reference/tasks/music-status)

<CardGroup cols={2}>
  <Card title="音乐生成" icon="music" href="/docs/cn/api-reference/audios/suno/generation">
    generation / inspo / sounds / lyrics
  </Card>

  <Card title="续写与上传" icon="upload" href="/docs/cn/api-reference/audios/suno/upload-extend">
    extend / uploadTask / uploadCover / uploadExtend
  </Card>

  <Card title="剪辑与改造" icon="scissors" href="/docs/cn/api-reference/audios/suno/edit">
    crop / fadeIn / fadeOut / replaceMusic / mashup / ...
  </Card>

  <Card title="分析与导出" icon="chart-line" href="/docs/cn/api-reference/audios/suno/analysis">
    midi / bpm / alignedLyrics / download / generateMp4
  </Card>
</CardGroup>


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