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

在向 WorkBuddy 的簡介中，具體說明流派、情緒、節奏及樂器。例如，「120 BPM 活潑獨立流行，配以木吉他和溫暖合成器音效」比「歡樂歌曲」更有效。請 agent 傳遞 negative_tags 以排除不想要的元素，例如重金屬或嘶吼。

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

suno-v5.5 是最新版本，擁有最高品質輸出，人聲清晰度及混音效果更佳。suno-v4 及 suno-v4.5 更便宜快速，適合草稿迭代。所有版本均在同一個 runapi MCP server 後端，切換時只需在提示詞中指定不同版本即可。

在 WorkBuddy 中我需要自行輪詢任務嗎？

不需要。Suno 任務為非同步，但工作台 agent 負責整個生命週期 — 透過 MCP 工具建立任務、輪詢直至狀態顯示為 completed，並將音訊 URL 發佈至對話中。您只需描述歌曲並等待即可。

RunAPI 是否提供官方 Suno API？

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

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

可以。請求 vocal_gender 為 male 或 female，並使用 negative_tags 排除不想要的風格。如需更精細的控制，可透過 personas endpoint 建立人物設定，並將回傳的 persona_id 搭配 persona_type 設為 voice 或 style 一同傳遞。

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

WORKBUDDY + SUNO

在 WorkBuddy 中使用 Suno。

Suno 可從文字提示詞或完整歌詞生成完整歌曲 — 包括人聲、樂器及混音。透過 RunAPI 可使用 v4 至 v5.5 版本，由於 Suno 沒有官方公開 API，RunAPI 提供相應的 API 存取。只需將 RunAPI 加入為 MCP server 一次，WorkBuddy agent 即可處理非同步任務並回傳完成的音訊 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，然後透過 streamable HTTP 將名為 runapi 的 MCP server 註冊至 https://runapi.ai/mcp。Suno 會與所有其他 RunAPI 模型並列，作為可呼叫的音樂工具 — 無需另外接入音樂服務。

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

向 agent 描述歌曲

以自然語言告知 WorkBuddy 您的需求並指定模式。使用 auto_lyrics 搭配提示詞讓 AI 撰寫歌詞，使用 exact_lyrics 搭配歌詞／風格／標題填入您自己的文字，或使用 instrumental 搭配風格／標題生成無人聲版本。Agent 會將您的簡介對應至 Suno 工具呼叫。

vocal_mode: auto_lyrics

讓 agent 輪詢並收集音訊

歌曲生成為非同步，視版本而定需時 30 秒至數分鐘。工作台 agent 輪詢任務直至狀態顯示為 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 以與聊天及圖像相同的金鑰，以程式化方式使用 v4 至 v5.5 版本。