WAV 生成/取得 API
介面說明
WAV 介面用於為既有歌曲生成或取得 WAV 無損音訊位址。
介面位址: POST /api/music/wav
計費: 免費。該介面用於生成或取得既有歌曲的 WAV 位址，不扣除額度。
等待時間與逾時（重要）：本介面是同步介面，回應返回時才代表訂單已被受理。實測多數請求 1–3 秒返回，約 10% 超過 30 秒，最長約 230 秒。請把用戶端逾時設為 300 秒以上；未收到回應不等於沒有生成，逾時後請勿立即重試。 連線中斷可稍後用
GET /api/music/songs確認。詳見 Suno API 介面文件總覽的「等待時間與逾時設定」。
請求參數
Headers
| 參數名 | 型別 | 必填 | 說明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer YOUR_API_KEY |
| Content-Type | string | 是 | application/json |
請求主體參數
| 參數名 | 型別 | 必填 | 預設值 | 說明 |
|---|---|---|---|---|
| model | string | 是 | - | 模型版本，例如 suno-v6 |
| audioId | string | 是 | - | 歌曲 ID |
| maxAttempts | number | 否 | 24 | 最大輪詢次數 |
| intervalSeconds | number | 否 | 5 | 輪詢間隔秒數 |
maxAttempts 和 intervalSeconds 都是 JSON 數字，intervalSeconds 的單位是秒，不是毫秒；通常保持預設值即可。它們只控制本次介面內部等待 WAV 就緒的次數和間隔，不會改變歌曲生成任務本身的狀態。
請求範例
curl -X POST https://www.suno-api.io/api/music/wav \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"audioId": "clip_id",
"maxAttempts": 24,
"intervalSeconds": 5
}'
回應結果
{
"code": 200,
"message": "success",
"data": {
"audioId": "clip_id",
"status": "complete",
"wavUrl": "https://media.code-go.com/assets/example.wav"
}
}
注意事項
WAV 生成和查詢由服務端根據歌曲記錄自動選擇可用資源，不需要客戶提供任何帳號資訊。
普通歌曲和分軌歌曲使用統一的受控媒體交付鏈路。WAV 會先由 CN2 下載並落盤，介面成功回應中的 data.wavUrl 只返回受控 CDN 位址，不返回 Suno 或 S3 臨時源位址。
已存在 ready WAV 資產時直接複用，不重複請求 Suno 或搬運檔案。尚未準備的 WAV 不會透過 /api/music/query 暴露 Suno/S3 位址；呼叫本介面或統一下載介面後才按需準備。
⚠️ WAV 位址有效期：7 天，請及時轉存。返回的
data.wavUrl由平台物件儲存提供，預設 7 天後失效（檔案到期回收，舊位址返回 404）。請在有效期內把 WAV 轉存到你自己的儲存；過期後重新呼叫本介面即可獲得新的有效位址。
如果歌曲資源暫時不可用，介面會返回 409。請稍後重試；服務端不會返回不穩定的臨時位址。