--- title: 透過 RunAPI 在 WorkBuddy 使用 Suno — Music MCP 指南 | RunAPI description: 透過 RunAPI MCP server 在 WorkBuddy 使用 Suno v4 至 v5.5 生成歌曲。一組 key、vocal mode，以及由工作台 agent 處理的非同步輪詢。 url: https://runapi.ai/zh-TW/workbuddy-suno.md canonical: https://runapi.ai/zh-TW/workbuddy-suno locale: zh-TW site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-suno zh-CN: https://runapi.ai/zh-CN/workbuddy-suno es: https://runapi.ai/es/workbuddy-suno ja: https://runapi.ai/ja/workbuddy-suno de: https://runapi.ai/de/workbuddy-suno fr: https://runapi.ai/fr/workbuddy-suno pt-BR: https://runapi.ai/pt-BR/workbuddy-suno ko: https://runapi.ai/ko/workbuddy-suno it: https://runapi.ai/it/workbuddy-suno nl: https://runapi.ai/nl/workbuddy-suno pl: https://runapi.ai/pl/workbuddy-suno tr: https://runapi.ai/tr/workbuddy-suno zh-TW: https://runapi.ai/zh-TW/workbuddy-suno zh-HK: https://runapi.ai/zh-HK/workbuddy-suno ar: https://runapi.ai/ar/workbuddy-suno x-default: https://runapi.ai/workbuddy-suno model: suno --- > HTML version: https://runapi.ai/zh-TW/workbuddy-suno > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 使用 Suno。 Suno 可依文字提示詞或精確歌詞生成完整歌曲 — 人聲、樂器與混音。由於 Suno 沒有官方公開 API，因此 RunAPI 提供其 API 存取。只要將 RunAPI 新增為 MCP server 一次，WorkBuddy agent 就會處理非同步 task，並回傳完成的音訊 URL。 - [取得 API Key](https://runapi.ai/zh-TW/login) - [閱讀說明文件](https://runapi.ai/zh-TW/docs/guides) 一個 MCP server · 從文字生成完整歌曲 · 非同步輪詢已處理 ### 提示詞 ```text 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 設定 ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### 回應 ```json { "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 } } ``` ## 三個步驟在 WorkBuddy 使用 Suno 1. **將 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 ` 2. **向 agent 描述歌曲** - 以自然語言告訴 WorkBuddy 你的需求，並指定 mode。使用 auto_lyrics 搭配提示詞讓 AI 撰寫歌詞；使用 exact_lyrics 搭配 lyrics/style/title 套用你的文字；或使用 instrumental 搭配 style/title 製作無人聲音樂。agent 會將你的需求對應為 Suno 工具呼叫。 `vocal_mode: auto_lyrics` 3. **讓 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 版本。 ## Suno 使用情境 - **YouTube 與社群媒體的背景音樂** - 向工作台 agent 描述情緒與曲風，取得原創背景音樂。不需授權費，也沒有權利金問題 -- 音軌會為你的內容全新生成，URL 會回傳至 WorkBuddy。 - **將歌詞完整呈現為一首歌** - 歌詞創作者可將文字貼入 WorkBuddy，並要求使用附帶風格描述的 exact_lyrics mode，聆聽其演唱成完整歌曲 — 在進錄音室前先完成製作 demo。 - **Podcast 的片頭與片尾音樂** - 透過指定曲風、情緒與時長，建立符合 podcast 調性的純音樂開場與片尾。讓 agent 在單一對話中生成數個變化版本，並挑選最合適的一個。 ## Suno + WorkBuddy 常見問題 ### 如何撰寫更好的 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。 - [WorkBuddy 設定指南 →](https://runapi.ai/zh-TW/workbuddy.md) - 尚未連線嗎？請先參閱 WorkBuddy 的 RunAPI MCP 設定指南。 - [Suno on RunAPI →](https://runapi.ai/zh-TW/models/suno.md) - 查看所有 Suno 版本、定價及可用 endpoint。 ## 立即在 WorkBuddy 試用 Suno。 取得免費 RunAPI key，將 MCP server 新增至 WorkBuddy，然後描述一首歌曲 — 工作台 agent 會回傳包含人聲、樂器與混音的完整音軌。 [瀏覽模型 →](https://runapi.ai/zh-TW/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-TW/.md) ### 產品 - [模型目錄](https://runapi.ai/zh-TW/models.md) - [價格](https://runapi.ai/zh-TW/pricing.md) - [提供商](https://runapi.ai/zh-TW/models#all-models) ### 開發者 - [文件](https://runapi.ai/zh-TW/docs/guides) - [SDK](https://runapi.ai/zh-TW/sdk.md) - [CLI](https://runapi.ai/zh-TW/cli.md) - [MCP Server](https://runapi.ai/zh-TW/mcp.md) - [x402](https://runapi.ai/zh-TW/x402.md) ### 指南 - [Claude Code 與 Cursor](https://runapi.ai/zh-TW/claude-code-vs-cursor.md) - [Cursor API 設定](https://runapi.ai/zh-TW/cursor-api-setup.md) - [RunAPI 與 OpenRouter](https://runapi.ai/zh-TW/openrouter-alternative.md) ### 公司 - [企業版](https://runapi.ai/zh-TW/contact.md) - [聯絡我們](https://runapi.ai/zh-TW/contact.md) ### 法律 - [服務條款](https://runapi.ai/zh-TW/terms.md) - [隱私權](https://runapi.ai/zh-TW/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-TW", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-TW/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-TW", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-TWicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "SoftwareApplication", "name": "適用於 WorkBuddy 的 RunAPI Suno", "applicationCategory": "DeveloperApplication", "description": "透過 RunAPI MCP server 在 WorkBuddy 使用 Suno v4 至 v5.5 生成歌曲。一組 key、vocal mode，以及由工作台 agent 處理的非同步輪詢。", "url": "https://runapi.ai/zh-TW/workbuddy-suno" }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "如何撰寫更好的 Suno 提示詞以獲得想要的曲風與風格？", "acceptedAnswer": { "@type": "Answer", "text": "提供給 WorkBuddy 的需求請具體說明曲風、情緒、節奏與樂器編制。例如，「節奏明快的 120 BPM indie pop，搭配木吉他與溫暖 synths」比「快樂的歌」效果更好。請 agent 傳遞 negative_tags，以排除 heavy metal 或 screaming 等不需要的元素。" } }, { "@type": "Question", "name": "應該使用哪個 Suno 版本——v4、v5 還是 v5.5？", "acceptedAnswer": { "@type": "Answer", "text": "suno-v5.5 是最新版本，提供最高品質的輸出，具備更清晰的人聲與混音。suno-v4 和 suno-v4.5 更便宜且更快速，適合草稿迭代。所有版本都位於同一個 runapi MCP server 後方，因此只要在提示詞中指定不同版本即可切換。" } }, { "@type": "Question", "name": "我必須在 WorkBuddy 中自行輪詢 task 嗎？", "acceptedAnswer": { "@type": "Answer", "text": "不需要。Suno task 雖然是非同步，但工作台 agent 會處理整個生命週期 — 它透過 MCP 工具建立 task、輪詢至狀態為 completed，並將音訊 URL 回傳到對話中。你只需描述歌曲並等待即可。" } }, { "@type": "Question", "name": "RunAPI 提供官方 Suno API 嗎？", "acceptedAnswer": { "@type": "Answer", "text": "Suno 未提供公開 API。RunAPI 透過與所有其他 RunAPI 模型相同的 API 金鑰與任務生命週期，提供對 Suno v4 至 v5.5 的程式化存取。無需 Suno 帳號或額外憑證。" } }, { "@type": "Question", "name": "我可以控制聲音性別和風格權重嗎？", "acceptedAnswer": { "@type": "Answer", "text": "可以。要求使用 vocal_gender male 或 female，並使用 negative_tags 排除不需要的風格。若要更精細控制，請透過 personas endpoint 建立 persona，並傳入回傳的 persona_id，同時將 persona_type 設為 voice 或 style。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "HowTo", "name": "如何透過 RunAPI 在 WorkBuddy 使用 Suno", "description": "將 RunAPI 新增為 WorkBuddy 的 MCP server，向工作台 agent 描述歌曲需求，讓它執行非同步 Suno task 並回傳完成的音訊 URL。", "step": [ { "@type": "HowToStep", "position": 1, "name": "將 RunAPI 新增為 MCP server", "text": "在啟動 WorkBuddy 的環境中設定 RUNAPI_API_KEY，然後註冊名為 runapi、透過 streamable HTTP 指向 https://runapi.ai/mcp 的 MCP server。Suno 會與所有其他 RunAPI model 一同顯示為可呼叫的音樂工具 — 無須另外串接音樂服務。", "url": "https://runapi.ai/zh-TW/workbuddy-suno#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "向 agent 描述歌曲", "text": "以自然語言告訴 WorkBuddy 你的需求，並指定 mode。使用 auto_lyrics 搭配提示詞讓 AI 撰寫歌詞；使用 exact_lyrics 搭配 lyrics/style/title 套用你的文字；或使用 instrumental 搭配 style/title 製作無人聲音樂。agent 會將你的需求對應為 Suno 工具呼叫。", "url": "https://runapi.ai/zh-TW/workbuddy-suno#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "讓 agent 輪詢並收取音訊", "text": "歌曲生成為非同步作業，依版本不同需時 30 秒至數分鐘。工作台 agent 會輪詢 task，直到狀態為 completed，接著將輸出音訊 URL 回傳至對話中 — 你完全不需要自行處理 task_id。", "url": "https://runapi.ai/zh-TW/workbuddy-suno#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "首頁", "item": "https://runapi.ai/zh-TW" }, { "@type": "ListItem", "position": 2, "name": "適用於 WorkBuddy 的 RunAPI Suno", "item": "https://runapi.ai/zh-TW/workbuddy-suno" } ] } ] ```