風格增強 API
介面說明
風格增強用於把簡短風格標籤擴展成更完整、更適合 Suno 生成的風格描述，也可以根據完整歌詞生成風格段落。
介面位址：POST /api/music/boost-style
計費：免費額度內不收費（每個使用者每分鐘最多 10 次，每天最多 300 次）；超出免費額度後按 0.1 元/次收費。
超限辨識：超出免費額度時請求仍會正常執行，回應標頭會帶 X-Suno-Helper-Free: false 和 X-Suno-Helper-Over-Limit: minute（或 day），可據此在用戶端提示本次已按次計費。
推薦模型：suno-v6。可用 suno-v6、suno-v6-wild 或 suno-v6-mini。
中文輸出：當請求內容（originalTags/lyrics/user_guidance）包含中文且未自行宣告語言時，服務會自動在 original_tags 後追加 （请用中文描述），並補充 user_guidance=语言：简体中文；乐器名也用中文，以提高中文風格描述的命中率。實際下發的取值會在回應裡的 appliedOriginalTags、appliedUserGuidance 返回。若傳入內容已明確寫了語言（例如「用簡體中文描述」），服務不會做任何改寫。
驗證
| 參數名 | 型別 | 必填 | 說明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer YOUR_API_KEY |
| Content-Type | string | 是 | application/json |
請求參數
| 參數名 | 型別 | 必填 | 預設值 | 說明 |
|---|---|---|---|---|
| model | string | 是 | - | 對客模型名：suno-v6、suno-v6-wild 或 suno-v6-mini |
| originalTags | string | 否 | - | 原始風格標籤 |
| original_tags | string | 否 | - | originalTags 的相容別名 |
| style | string | 否 | - | 原始風格標籤，和 originalTags 二選一 |
| instrumental | boolean | 否 | false | 是否按純音樂方向增強 |
| lyrics | string | 否 | - | 完整歌詞；傳入後按歌詞內容生成風格描述 |
| user_guidance | string | 否 | - | 使用者自然語言要求，例如「加入嗩吶和二胡，男聲，節奏更快」；平台側同名字段，直接透傳 |
請求範例
curl -X POST https://www.suno-api.io/api/music/boost-style \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"originalTags": "pop, piano, male vocal",
"lyrics": "[Verse]\n夜色落在窗前\n[Chorus]\n我們向光而行",
"user_guidance": "加入嗩吶和二胡，男聲，節奏更快",
"instrumental": false
}'
回應結果
{
"code": 200,
"message": "success",
"data": {
"originalTags": "pop, piano, male vocal",
"instrumental": false,
"upsampledStyle": "Mandopop, expressive male vocal, warm piano ballad...",
"requestId": "request_id"
}
}
upsampledStyle 是應寫回 Style 輸入框的完整風格描述。