区間削除 API
インターフェースの説明
区間削除は、既存の楽曲から指定した時間帯を削除し、残りをつないで新しいバージョンにします。
エンドポイント: POST /api/music/remove-section
課金: 有料。要求したモデルに応じて課金され、実際の請求額は管理画面の価格設定に従います。
推奨モデル: suno-v6。suno-v6、suno-v6-wild、suno-v6-mini が利用できます。
待ち時間とタイムアウト（重要）: 本エンドポイントは同期インターフェースで、レスポンスが返った時点で初めて注文が受理され生成に投入されます。実測では多くのリクエストが 1〜3 秒で返り、約 10% が 30 秒を超え、最長は約 230 秒です。クライアントのタイムアウトは 300 秒以上に設定してください。レスポンスが無いことは未生成を意味せず、タイムアウト直後の再試行は注文の重複と二重課金につながります。 接続が切れた場合は少し後に
GET /api/music/songsで確認できます。詳しくは新版 API 概要の「待ち時間とタイムアウト設定」をご覧ください。
認証
| パラメータ名 | 型 | 必須 | 説明 |
|---|---|---|---|
| Authorization | string | はい | Bearer YOUR_API_KEY |
| Content-Type | string | はい | application/json |
リクエストパラメータ
| パラメータ名 | 型 | 必須 | 既定値 | 説明 |
|---|---|---|---|---|
| model | string | はい | - | 対客モデル名: suno-v6、suno-v6-wild、suno-v6-mini |
| source_clip_id | string | はい | - | ソース楽曲の実際の song_id。完了済みで、現在の API Key から参照できる必要があります |
| crop_start_s | number | はい | - | 削除する区間の開始秒。0 以上である必要があります |
| crop_end_s | number | はい | - | 削除する区間の終了秒。crop_start_s より大きい必要があります |
| song_title | string | いいえ | - | 結果のタイトル |
リクエスト例
curl -X POST https://www.suno-api.io/api/music/remove-section \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"source_clip_id": "source_song_id",
"crop_start_s": 30,
"crop_end_s": 45,
"song_title": "削除版"
}'
レスポンス結果
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "result_song_id",
"song_title": "削除版",
"status": "processing"
}
]
}
}
1 回の呼び出しで 1 件だけ返ります（編集系の操作は 2 曲出しません）。clips[].song_id を保存し、楽曲照会 API で completed になるまでポーリングしてください。
注意事項
- 削除する区間は
0 <= crop_start_s < crop_end_sを満たし、かつソース楽曲の長さ内である必要があります。 - 区間を残したい場合はトリミング API を使ってください。