伴奏追加 API

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

インターフェースの説明

伴奏追加は、既存の楽曲に再編曲・楽器の追加・新しい伴奏構造の生成を行います。

エンドポイント: POST /api/music/add-instrumental

課金: 有料。要求したモデルに応じて課金され、実際の請求額は管理画面の価格設定に従います。

Max Mode / Variety: 本エンドポイントは任意パラメータ max_mode と variety（0〜4）に対応しています。 max_mode を有効にするとこの 1 回は 2 倍の価格で課金され、variety に追加課金はありません。両者の意味と 書き方は新版 API 概要の「高度なパラメータ」の節をご覧ください。

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

待ち時間とタイムアウト（重要）: 本エンドポイントは同期インターフェースで、レスポンスが返った時点で初めて注文が受理され生成に投入されます。実測では多くのリクエストが 1〜3 秒で返り、約 10% が 30 秒を超え、最長は約 230 秒です。クライアントのタイムアウトは 300 秒以上に設定してください。レスポンスが無いことは未生成を意味せず、タイムアウト直後の再試行は注文の重複と二重課金につながります。 接続が切れた場合は少し後に GET /api/music/songs で確認できます。詳しくは新版 API 概要の「待ち時間とタイムアウト設定」をご覧ください。

認証

リクエストパラメータ

リクエスト例

curl -X POST https://www.suno-api.io/api/music/add-instrumental \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "lyrics": "",
    "style_tags": "cinematic, strings, acoustic guitar",
    "song_title": "伴奏強化版",
    "audio_weight": 1,
    "wait_completion": false
  }'

レスポンス結果

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "伴奏強化版",
        "status": "pending"
      },
      {
        "song_id": "result_song_id_2",
        "song_title": "伴奏強化版",
        "status": "pending"
      }
    ]
  }
}

1 回の呼び出しで 2 件返ります（2 曲として課金）。例も 2 件で示しています。clips 配列の長さを基準にし、固定件数でループを書かないでください。clips[].song_id を保存し、楽曲照会 API で completed になるまでポーリングします。完了後は audio_url で再生・ダウンロードできます。詳しくは WAV 生成/取得 API と各ダウンロード用エンドポイントをご覧ください。

注意事項

• source_clip_id は、実在し、完了済みで、現在の API Key から参照できる楽曲 ID である必要があります。pending: のプレースホルダー ID は使えません。
• 伴奏追加はカバーではありません。カバーが必要な場合はソース clip からのカバー API を使ってください。
• 既存楽曲に特定の楽器や音軌を追加したい場合は、加軌 API を使ってください。