> ## 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 音樂生成與編輯接口總覽,任務生命週期與定價

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/zh-Hant/api-reference/tasks/music-status)

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

  <Card title="續寫與上傳" icon="upload" href="/docs/zh-Hant/api-reference/audios/suno/upload-extend">
    extend / uploadTask / uploadCover / uploadExtend
  </Card>

  <Card title="剪輯與改造" icon="scissors" href="/docs/zh-Hant/api-reference/audios/suno/edit">
    crop / fadeIn / fadeOut / replaceMusic / mashup / ...
  </Card>

  <Card title="分析與匯出" icon="chart-line" href="/docs/zh-Hant/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.