> ## 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 音楽生成・編集 API の概要、タスクライフサイクルと料金

Suno 音楽シリーズは、生成・延長・編集・ステム分離・分析までの完全な AI 音楽ワークフローを提供します。すべての操作は同一の送信エンドポイントを共有し、URL パスの `{operation}` で区別します:

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

すべての操作は**非同期タスク**です。送信後にタスク ID が返り、タスク照会 API で結果をポーリングします。返される音声・カバー・動画などのメディア 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` は高品質ティア(2倍料金)。下表 **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` | 2曲のマッシュアップ | \$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 |

## タスクライフサイクル

```
submitted → queued / in_progress → completed / failed
```

* タスク失敗時はプリチャージが自動返金
* `download`/`midi`/`bpm`/`alignedLyrics` 等は構造化データを返却。詳細は [タスク状態照会](/docs/ja/api-reference/tasks/music-status)

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

  <Card title="延長とアップロード" icon="upload" href="/docs/ja/api-reference/audios/suno/upload-extend">
    extend / uploadTask / uploadCover / uploadExtend
  </Card>

  <Card title="編集と変換" icon="scissors" href="/docs/ja/api-reference/audios/suno/edit">
    crop / fadeIn / fadeOut / replaceMusic / mashup / ...
  </Card>

  <Card title="分析とエクスポート" icon="chart-line" href="/docs/ja/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.