支援的模型
可用的生成模型
請求只接受下列平台模型名稱。其他名稱，包括與現有模型相似的名稱，都不會被接受，也不會被自動對應。
| 模型名稱 | 顯示名稱 | 用途 | 狀態 |
|---|---|---|---|
suno-v6 |
Suno V6 | 預設生成模型 | 可用 |
suno-v6-wild |
Suno V6 Wild | V6 的 Wild 變體 | 可用 |
suno-v6-mini |
Suno V6 Mini | V6 的 Mini 變體 | 可用 |
建議使用的預設模型：suno-v6。
關於分軌
分軌是固定且獨立的機能，不需要選擇生成模型。只要送出原始歌曲與分軌模式（例如 two 或
twelve），回傳的軌數以回應內容為準。
model 參數
在生成端點中，model 通常是選填：
- 未填：使用預設值
suno-v6。 - 有填：必須是
suno-v6、suno-v6-wild或suno-v6-mini。 - 只接受上表中的模型名稱。
最小生成範例
curl -X POST https://www.suno-api.io/api/music/create \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"description": "一首關於春天第一天的輕快民謠",
"model": "suno-v6"
}'
使用 V6 變體的範例
{
"model": "suno-v6-wild",
"description": "一首結構實驗性的電子作品"
}
已下線的模型
下列模型已不再接受新請求：
suno-v2suno-v3suno-v3-5suno-v4suno-v4-5suno-v4-5-allsuno-v4-5-plussuno-v5suno-v5-5
舊歌曲與舊任務仍可能顯示舊的 model_name 或 model_version。那是歷史資料，不代表舊模型能接受
新請求。
為了與既有客戶端相容，帶有已下線模型的請求會以目前的預設模型 suno-v6 處理，而不是被拒絕。
任務也會記錄為 suno-v6，且不會回傳「模型不可用」的錯誤。不過仍請盡快把範例更新為目前的名稱。
列出模型
GET /v1/models 至少應包含下列音樂模型：
{
"object": "list",
"data": [
{ "id": "suno-v6", "object": "model", "owned_by": "suno" },
{ "id": "suno-v6-wild", "object": "model", "owned_by": "suno" },
{ "id": "suno-v6-mini", "object": "model", "owned_by": "suno" }
]
}
回應也可能包含歌詞模型、相容性路由或內部模型。請不要與生成音樂用的 V6 模型混淆。
如何選擇 V6 變體
大多數整合用預設模型就很足夠。三個變體的差異在於對提示詞的忠實度與結果的多樣性。
| 變體 | 使用時機 |
|---|---|
suno-v6 |
想要可預期且貼近描述的結果時。這是預設值，也是正式環境的正確選擇。 |
suno-v6-wild |
想要更多變化、且能比較多個版本時。適合探索某種風格。 |
suno-v6-mini |
想在正式生成前用最低成本測試提示詞時。 |
由於每次執行都回傳兩首，實務上的流程是先用 suno-v6-mini 試稿，再把通過的提示詞放到
suno-v6 執行，挑選要發布的版本。
費用與退費
計費以請求為單位，而不是以模型為單位：每次執行 0.6 ¥ 並回傳兩首。生成失敗會自動退費，因此 失敗的嘗試不會消耗餘額。下載不限次數，也永遠不會另外收費。