靈感提示詞 API

2026-09-18 更新 · Suno-API 團隊

介面說明

靈感提示詞介面用於取得隨機歌曲描述、歌詞主題和風格標籤建議，適合做「隨機靈感」和「重新整理標籤」按鈕。

介面位址：POST /api/prompts/suggestions

計費：免費額度內不收費（每個使用者每分鐘最多 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。

驗證

請求參數

請求範例

curl -X POST https://www.suno-api.io/api/prompts/suggestions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6"
  }'

回應結果

{
  "code": 200,
  "message": "success",
  "data": {
    "prompts": ["A dreamy synth-pop track about city lights after rain"],
    "lyrics_prompts": ["寫一首關於夜晚、重逢和遺憾的中文歌詞"],
    "tags": ["dreamy synth-pop", "warm piano", "male vocal"],
    "is_pending_personalization": false
  }
}

欄位說明