裁剪 API
介面說明
裁剪用於保留既有歌曲的指定時間段，生成裁剪後的新版本。
介面位址：POST /api/music/crop
計費：收費，依請求模型計費，實際扣費以後台價格設定為準。
推薦模型：suno-v6。可用 suno-v6、suno-v6-wild 或 suno-v6-mini。
等待時間與逾時（重要）：本介面是同步介面，回應返回時才代表訂單已被受理並提交生成。實測多數請求 1–3 秒返回，約 10% 超過 30 秒，最長約 230 秒。請把用戶端逾時設為 300 秒以上；未收到回應不等於沒有生成，逾時後請勿立即重試（會重複下單、重複扣費）。 連線中斷可稍後用
GET /api/music/songs確認。詳見 Suno 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/crop \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"source_clip_id": "source_song_id",
"crop_start_s": 10,
"crop_end_s": 48,
"song_title": "裁剪版本"
}'
回應結果
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "result_song_id",
"song_title": "裁剪版本",
"status": "processing"
}
]
}
}
一次回傳 1 條結果（編輯類動作不是一次出 2 首）。請保存 clips[].song_id，再使用歌曲查詢 API輪詢到 completed。首次回應偶爾還沒登記出可查詢的 song_id，稍等片刻再查詢即可。
注意事項
- 保留區間必須滿足
0 <= crop_start_s < crop_end_s，並且位於來源歌曲時長內。 - 與裁剪不同，刪除片段請使用刪減 API。