如何撰寫更好的 Suno 提示詞以獲得想要的曲風與風格？

提供給 WorkBuddy 的需求請具體說明曲風、情緒、節奏與樂器編制。例如，「節奏明快的 120 BPM indie pop，搭配木吉他與溫暖 synths」比「快樂的歌」效果更好。請 agent 傳遞 negative_tags，以排除 heavy metal 或 screaming 等不需要的元素。

應該使用哪個 Suno 版本——v4、v5 還是 v5.5？

suno-v5.5 是最新版本，提供最高品質的輸出，具備更清晰的人聲與混音。suno-v4 和 suno-v4.5 更便宜且更快速，適合草稿迭代。所有版本都位於同一個 runapi MCP server 後方，因此只要在提示詞中指定不同版本即可切換。

我必須在 WorkBuddy 中自行輪詢 task 嗎？

不需要。Suno task 雖然是非同步，但工作台 agent 會處理整個生命週期 — 它透過 MCP 工具建立 task、輪詢至狀態為 completed，並將音訊 URL 回傳到對話中。你只需描述歌曲並等待即可。

RunAPI 提供官方 Suno API 嗎？

Suno 未提供公開 API。RunAPI 透過與所有其他 RunAPI 模型相同的 API 金鑰與任務生命週期，提供對 Suno v4 至 v5.5 的程式化存取。無需 Suno 帳號或額外憑證。

我可以控制聲音性別和風格權重嗎？

可以。要求使用 vocal_gender male 或 female，並使用 negative_tags 排除不需要的風格。若要更精細控制，請透過 personas endpoint 建立 persona，並傳入回傳的 persona_id，同時將 persona_type 設為 voice 或 style。

Claude 訪客：新帳戶可在 30 天內獲得 $1.00 API 贈送額度。每人限領一次，僅用於 API 用量。

WORKBUDDY + SUNO

在 WorkBuddy 使用 Suno。

Suno 可依文字提示詞或精確歌詞生成完整歌曲 — 人聲、樂器與混音。由於 Suno 沒有官方公開 API，因此 RunAPI 提供其 API 存取。只要將 RunAPI 新增為 MCP server 一次，WorkBuddy agent 就會處理非同步 task，並回傳完成的音訊 URL。

取得 API Key 閱讀說明文件

一個 MCP server · 從文字生成完整歌曲 · 非同步輪詢已處理

Using the runapi MCP server, generate a song with Suno.

Requirements:
- Call the Suno text_to_music tool exposed by the runapi MCP server.
- Set model to "suno-v5.5".
- Set vocal_mode to "auto_lyrics" so the lyrics are written from my brief.
- Prompt: an upbeat indie pop track about coding late at night,
  warm synths and acoustic guitar, female vocals.
- The task is async — keep polling until the status is "completed",
  then give me the audio URL.

{
  "mcp_servers": {
    "runapi": {
      "url": "https://runapi.ai/mcp",
      "transport": "streamable_http",
      "headers": {
        "Authorization": "Bearer $RUNAPI_API_KEY"
      }
    }
  }
}

{
  "task_id": "tsk_abc123",
  "status": "completed",
  "model": "suno-v5.5",
  "output": {
    "audio_url": "https://media.runapi.ai/outputs/tsk_abc123.mp3",
    "title": "Midnight Compile",
    "duration_seconds": 187
  }
}

複製 MCP 設定以連線 suno

運作方式

三個步驟在 WorkBuddy 使用 Suno

將 RunAPI 新增為 MCP server

在啟動 WorkBuddy 的環境中設定 RUNAPI_API_KEY，然後註冊名為 runapi、透過 streamable HTTP 指向 https://runapi.ai/mcp 的 MCP server。Suno 會與所有其他 RunAPI model 一同顯示為可呼叫的音樂工具 — 無須另外串接音樂服務。

export RUNAPI_API_KEY=runapi_xxx
# MCP server: runapi → https://runapi.ai/mcp

向 agent 描述歌曲

以自然語言告訴 WorkBuddy 你的需求，並指定 mode。使用 auto_lyrics 搭配提示詞讓 AI 撰寫歌詞；使用 exact_lyrics 搭配 lyrics/style/title 套用你的文字；或使用 instrumental 搭配 style/title 製作無人聲音樂。agent 會將你的需求對應為 Suno 工具呼叫。

vocal_mode: auto_lyrics

讓 agent 輪詢並收取音訊

歌曲生成為非同步作業，依版本不同需時 30 秒至數分鐘。工作台 agent 會輪詢 task，直到狀態為 completed，接著將輸出音訊 URL 回傳至對話中 — 你完全不需要自行處理 task_id。

"status": "completed"

參數

Suno text_to_music 參數

參數	類型	說明
`model`	`string`	必填。suno-v4、suno-v4.5、suno-v4.5-all、suno-v4.5-plus、suno-v5 或 suno-v5.5。
`vocal_mode`	`string`	必填。auto_lyrics（AI 根據提示詞撰寫歌詞）、exact_lyrics（自行提供歌詞／風格／標題）或 instrumental（純音樂，無人聲，需提供風格／標題）。
`prompt`	`string`	auto_lyrics 模式的歌曲簡述。描述曲風、情緒、節奏與主題。exact_lyrics 和 instrumental 模式中禁止使用。
`lyrics`	`string`	要演唱的完整歌詞。exact_lyrics 模式必填。auto_lyrics 和 instrumental 模式中禁止使用。
`style`	`string`	音樂風格描述，例如：lo-fi hip hop、80s synthwave。exact_lyrics 和 instrumental 模式必填。
`vocal_gender`	`string`	選填。male 或 female。
`negative_tags`	`string`	選填。要避免的風格，例如：heavy metal、screaming。

WorkBuddy 上的 Suno 是什麼？

Suno 是文字轉音樂 AI，可根據文字提示詞或你自己的歌詞生成完整歌曲 -- 人聲、樂器與混音。它就像一個作曲草稿工具：你描述曲風、情緒與節奏，即可獲得完整音軌。由於 Suno 沒有官方公開 API，WorkBuddy 透過 RunAPI MCP server 存取它，讓工作台 agent 能以用於 chat 與圖片的同一組 key，以程式化方式存取 v4 至 v5.5 版本。