ボーカル除去 API

2026-09-18 更新 · Suno-API チーム

インターフェースの説明

ボーカル除去は、既存の楽曲をボーカルと伴奏の 2 トラックに分解します。「ステム分離（ボーカル・伴奏分離）」のショートカット版で、呼び出し側はソース楽曲 ID を 1 つ渡すだけでよく、分離モードを選ぶ必要はありません。サーバー側は常に 2 トラック（two）として処理します。

エンドポイント: POST /api/music/vocal-removal

課金: 無料。本エンドポイントはトラック分割のみを行い、生成費用は発生せず、課金の記録も作成しません。

推奨モデル: suno-v6。suno-v6、suno-v6-wild、suno-v6-mini が利用できます。

認証

リクエストパラメータ

互換エイリアス: sourceClipId、audio_id、audioId、song_id はいずれも source_clip_id の代わりに使えます。

リクエスト例

curl -X POST https://www.suno-api.io/api/music/vocal-removal \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "song_title": "ボーカル除去"
  }'

レスポンス結果

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "vocals_clip_id",
        "song_title": "ボーカル除去 (Vocals)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      },
      {
        "song_id": "instrumental_clip_id",
        "song_title": "ボーカル除去 (Instrumental)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      }
    ]
  }
}

1 回の送信で 2 バージョン × {Vocals, Instrumental} が返るため、clips は通常 4 件になります。stem_from_id でグループ化し、song_title の接尾辞でボーカルと伴奏を区別してください。

注意事項

• 結果のトラックは楽曲照会 API（POST /api/music/query）で completed になるまでポーリングしてから使用してください。GET /api/music/songs/:song_id と楽曲履歴一覧は現時点でボーカル除去が生成したトラックを含みません。これは既知の差異です。
• 2 トラック／マルチトラックモードを選びたい場合や、トラック名でカスタム分割したい場合はステム分離（ボーカル・伴奏分離）APIをご利用ください。
• 不要なトラックはステム削除 APIで非表示にできます。削除リクエストを繰り返し送らないでください。