ステム削除 API
インターフェースの説明
ステム削除は、すでに生成されたステムトラックを一覧から隠します。削除はソフト削除で、バックエンドは
ステム行に stem_hidden の印を付けるだけです。元の音声・MIDI・ダウンロード用リソースは保持され、同じ楽曲から後で
新しいステムを分離し直すこともできます。
エンドポイント: POST /api/music/stem-delete
課金: 無料。削除はプラットフォーム内の表示状態を更新するだけで、Suno を呼び出さず課金も発生しません。
推奨モデル: suno-v6。suno-v6、suno-v6-wild、suno-v6-mini が利用できます。
認証
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| Authorization | string | はい | Bearer YOUR_API_KEY |
| Content-Type | string | はい | application/json |
リクエストパラメータ
| パラメータ名 | 型 | 必須 | 既定値 | 説明 |
|---|---|---|---|---|
| song_id | string | いいえ | - | 単一のステムトラックの song_id（/api/music/separate が返すトラック ID） |
| song_ids | string[] | いいえ | - | 一括指定。1 回につき最大 100 件 |
| stem_batch_id | string | いいえ | - | バッチ単位で削除：その自動分離バッチの全トラックを削除します |
| stem_mode | string | いいえ | - | モード単位で削除：例えば two、twelve |
song_id / song_ids / stem_batch_id / stem_mode のうち少なくとも 1 つが必要で、指定がない場合は 400 を返します。
リクエスト例
curl -X POST https://www.suno-api.io/api/music/stem-delete \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"song_ids": ["stem_track_id_1", "stem_track_id_2"]
}'
レスポンス結果
{
"code": 200,
"message": "success",
"data": {
"hidden": 2,
"affected_sources": 1
}
}
| フィールド | 型 | 説明 |
|---|---|---|
| hidden | number | 今回隠したトラック数 |
| affected_sources | number | 影響を受けたソース楽曲の数 |
注意事項
- 冪等：すでに隠れている、または ID が存在しない場合は
hidden: 0を返しエラーになりません。繰り返し呼び出しても安全です。 - 削除は現在の API Key に属する楽曲にのみ影響します。自分のものではないトラックは変更されません。
- 一覧で最後の可視ステムを隠すと、ソース楽曲の「分離済み」の印もあわせて消えます。