續寫 API
介面說明
續寫用於從既有歌曲的指定時間點繼續生成後續片段。
介面位址：POST /api/music/extend
計費：收費，目前預設 0.6 元/次。實際扣費以目前後台價格設定為準。
Max Mode / Variety：本介面支援選用參數 max_mode 與 variety（0-4）。開啟 max_mode
時本次依 2 倍價格計費（0.6 → 1.2 元/次），variety 不額外計費；兩者含義與寫法見
Suno API 介面文件總覽 的「進階參數」一節。
等待時間與逾時（重要）：本介面是同步介面，回應返回時才代表訂單已被受理並提交生成。實測多數請求 1–3 秒返回，約 10% 超過 30 秒，最長約 230 秒。請把用戶端逾時設為 300 秒以上；未收到回應不等於沒有生成，逾時後請勿立即重試（會重複下單、重複扣費）。 連線中斷可稍後用
GET /api/music/songs確認。詳見 Suno API 介面文件總覽的「等待時間與逾時設定」。
請求參數
Headers
| 參數名 | 型別 | 必填 | 說明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer YOUR_API_KEY |
| Content-Type | string | 是 | application/json |
Body 參數
| 參數名 | 型別 | 必填 | 預設值 | 說明 |
|---|---|---|---|---|
| model | string | 否 | suno-v6 | 對客模型名：suno-v6、suno-v6-wild 或 suno-v6-mini |
| audioId | string | 是 | - | 要續寫的歌曲 ID |
| prompt | string | 是 | - | 續寫描述 |
| continueAt | number | 是 | - | 續寫起點，單位秒。必須大於 0 且小於來源歌曲時長；建議起點之後至少留 10 秒，否則成品只有那幾秒 |
| style | string | 否 | - | 風格標籤 |
| negativeTags | string | 否 | - | 負向風格 |
| title | string | 否 | - | 標題 |
| sourceAudioUrl | string | 否 | - | 來源音訊 URL |
| sourceFileName | string | 否 | - | 來源檔名 |
| waitAudio | boolean | 否 | false | 是否等待音訊完成 |
請求範例
curl -X POST https://www.suno-api.io/api/music/extend \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"audioId": "clip_id",
"prompt": "繼續副歌，情緒更強",
"continueAt": 60,
"style": "Mandopop, rock",
"negativeTags": "noise",
"title": "續寫版本",
"waitAudio": false
}'
回應結果
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "extended_clip_id",
"song_title": "續寫版本",
"status": "pending"
}
]
}
}
相容欄位
舊欄位仍相容：
| 新欄位 | 相容舊欄位 |
|---|---|
| audioId | song_id、audio_id |
| prompt | description |
| continueAt | start_time、continue_at |
| style | style_tags、tags |
| negativeTags | negative_tags |
| waitAudio | wait_audio |
注意事項
- 起點別貼著結尾：續寫出來的長度基本上等於「起點之後剩下的部分」。起點離結尾太近時，成品就只有幾秒——實測 242 秒的歌從第 240 秒續寫，只出了 2.7 秒（照樣按次收費）。建議起點之後至少留 10 秒。
- 續寫沒有「來源太短」的門檻：實測 9.6 秒的短素材、從第 5 秒起續寫也能正常出歌，不會因為來源短或剩餘短而被拒。
- 起點必須大於 0：
continueAt=0會被平台受理後作廢，而且不回傳失敗原因，請直接從第 1 秒之後開始。 - 一次回傳 2 條結果（按 2 首計費）；請以
clips陣列長度為準。 - 結果是新的作品，原曲不受影響。