歌詞生成 API

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

介面說明

歌詞生成用於根據主題、既有歌詞脈絡和風格要求生成或改寫歌詞。目前介面已升級為最新歌詞生成契約，可直接用於專業模式生成。

介面位址：POST /api/lyrics/generate

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

驗證

請求參數

instruction 相容舊欄位 theme 和 prompt。metadata.lyrics_model 預設 default，metadata.enable_thinking 預設 false。

語言控制

目前介面沒有獨立的 language 請求欄位。歌詞語言由 instruction 的內容決定，style 只能起輔助作用。

要生成中文歌詞，請在 instruction 中明確寫出目標語言，例如：

{
  "model": "suno-v6",
  "instruction": "请用中文写歌词，主题是夏夜海边重逢",
  "style": "Mandopop, 中文流行"
}

也可以寫成 "Write the lyrics in Chinese about ..."。要生成英文歌詞，則寫 "请用英文写歌词" 或 "Write the lyrics in English"。只傳英文主題而不說明目標語言時，結果可能是英文。

請求範例

curl -X POST https://www.suno-api.io/api/lyrics/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "instruction": "關於畢業季和重新出發的中文歌詞",
    "style": "流行搖滾，真摯，副歌有記憶點",
    "title": "重新出發",
    "metadata": {
      "lyrics_model": "default",
      "enable_thinking": false
    }
  }'

回應結果

{
  "code": 200,
  "message": "success",
  "data": {
    "lyrics": "[Verse]\n風吹過操場\n我們揮手告別昨天",
    "edited_lyrics": "[Verse]\n風吹過操場\n我們揮手告別昨天",
    "lyrics_id": "lyrics_id",
    "lyrics_request_id": "lyrics_request_id"
  }
}

edited_lyrics 是應填入歌詞框的完整歌詞。lyrics_id 和 lyrics_request_id 可用於追蹤，可能因介面返回情況而為空；不要把它們當作歌曲 ID。

相容說明

• 舊欄位 theme、prompt 仍可使用，會映射為 instruction。
• 「歌詞專案 / 歌詞作者」系列介面已下線：需要留存生成結果時，請自行保存介面返回的 edited_lyrics。