--- title: 透過 RunAPI 在 WorkBuddy 使用 Suno — 音樂 MCP 指南 | RunAPI description: 透過 RunAPI MCP server 在 WorkBuddy 中以 Suno v4 至 v5.5 生成歌曲。一個金鑰、多種人聲模式，由工作台 agent 處理非同步輪詢。 url: https://runapi.ai/zh-HK/workbuddy-suno.md canonical: https://runapi.ai/zh-HK/workbuddy-suno locale: zh-HK 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-HK/workbuddy-suno > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 Suno。 Suno 可從文字提示詞或完整歌詞生成完整歌曲 — 包括人聲、樂器及混音。透過 RunAPI 可使用 v4 至 v5.5 版本，由於 Suno 沒有官方公開 API，RunAPI 提供相應的 API 存取。只需將 RunAPI 加入為 MCP server 一次，WorkBuddy agent 即可處理非同步任務並回傳完成的音訊 URL。 - [取得 API Key](https://runapi.ai/zh-HK/login) - [閱讀文件](https://runapi.ai/zh-HK/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，然後透過 streamable HTTP 將名為 runapi 的 MCP server 註冊至 https://runapi.ai/mcp。Suno 會與所有其他 RunAPI 模型並列，作為可呼叫的音樂工具 — 無需另外接入音樂服務。 `export RUNAPI_API_KEY=runapi_xxx # MCP server: runapi → https://runapi.ai/mcp ` 2. **向 agent 描述歌曲** - 以自然語言告知 WorkBuddy 您的需求並指定模式。使用 auto_lyrics 搭配提示詞讓 AI 撰寫歌詞，使用 exact_lyrics 搭配歌詞／風格／標題填入您自己的文字，或使用 instrumental 搭配風格／標題生成無人聲版本。Agent 會將您的簡介對應至 Suno 工具呼叫。 `vocal_mode: auto_lyrics` 3. **讓 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 版本。 ## Suno 使用場景 - **YouTube 及社交媒體背景音樂** - 向工作台 agent 描述情緒與流派，請其生成原創背景音樂。無需授權費用，無版稅問題 — 音軌全新生成，URL 直接回傳至 WorkBuddy。 - **將歌詞聆聽為完整歌曲** - 歌詞創作者可將文字貼入 WorkBuddy，並以風格描述請求 exact_lyrics 模式，聆聽歌詞以完整歌曲形式演繹 — 錄音室時間前的製作示範。 - **Podcast 片頭及片尾音樂** - 透過指定流派、情緒及時長，為 podcast 創作與其風格相符的器樂片頭及片尾音樂。在單一對話中讓 agent 生成多個變體，選出最佳版本。 ## Suno + WorkBuddy 常見問題 ### 如何撰寫更好的 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 一同傳遞。 - [WorkBuddy 設定指南 →](https://runapi.ai/zh-HK/workbuddy.md) - 尚未連接？請先參閱 WorkBuddy 的 RunAPI MCP 設定指南。 - [Suno on RunAPI →](https://runapi.ai/zh-HK/models/suno.md) - 查看所有 Suno 版本、定價及可用 endpoint。 ## 立即在 WorkBuddy 中試用 Suno。 獲取免費 RunAPI 金鑰，將 MCP server 加入 WorkBuddy，描述一首歌 — 工作台 agent 將回傳包含人聲、樂器及混音的完整音軌。 [瀏覽模型 →](https://runapi.ai/zh-HK/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-HK/.md) ### 產品 - [模型目錄](https://runapi.ai/zh-HK/models.md) - [收費](https://runapi.ai/zh-HK/pricing.md) - [服務商](https://runapi.ai/zh-HK/models#all-models) ### 開發者 - [文件](https://runapi.ai/zh-HK/docs/guides) - [SDK](https://runapi.ai/zh-HK/sdk.md) - [CLI](https://runapi.ai/zh-HK/cli.md) - [MCP Server](https://runapi.ai/zh-HK/mcp.md) - [x402](https://runapi.ai/zh-HK/x402.md) ### 指南 - [Claude Code 與 Cursor](https://runapi.ai/zh-HK/claude-code-vs-cursor.md) - [Cursor API 設定](https://runapi.ai/zh-HK/cursor-api-setup.md) - [RunAPI 與 OpenRouter](https://runapi.ai/zh-HK/openrouter-alternative.md) ### 公司 - [企業版](https://runapi.ai/zh-HK/contact.md) - [聯絡](https://runapi.ai/zh-HK/contact.md) ### 法律 - [條款](https://runapi.ai/zh-HK/terms.md) - [私隱](https://runapi.ai/zh-HK/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-HK", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-HK/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-HK", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-HKicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "SoftwareApplication", "name": "適用於 WorkBuddy 的 RunAPI Suno", "applicationCategory": "DeveloperApplication", "description": "透過 RunAPI MCP server 在 WorkBuddy 中以 Suno v4 至 v5.5 生成歌曲。一個金鑰、多種人聲模式，由工作台 agent 處理非同步輪詢。", "url": "https://runapi.ai/zh-HK/workbuddy-suno" }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "如何撰寫更好的 Suno 提示詞以獲得想要的曲風和風格？", "acceptedAnswer": { "@type": "Answer", "text": "在向 WorkBuddy 的簡介中，具體說明流派、情緒、節奏及樂器。例如，「120 BPM 活潑獨立流行，配以木吉他和溫暖合成器音效」比「歡樂歌曲」更有效。請 agent 傳遞 negative_tags 以排除不想要的元素，例如重金屬或嘶吼。" } }, { "@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 中我需要自行輪詢任務嗎？", "acceptedAnswer": { "@type": "Answer", "text": "不需要。Suno 任務為非同步，但工作台 agent 負責整個生命週期 — 透過 MCP 工具建立任務、輪詢直至狀態顯示為 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_id 搭配 persona_type 設為 voice 或 style 一同傳遞。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "HowTo", "name": "如何透過 RunAPI 在 WorkBuddy 中使用 Suno", "description": "在 WorkBuddy 中將 RunAPI 加入為 MCP server，向工作台 agent 描述歌曲內容，讓它執行非同步 Suno 任務並回傳完成的音訊 URL。", "step": [ { "@type": "HowToStep", "position": 1, "name": "將 RunAPI 加入為 MCP server", "text": "在啟動 WorkBuddy 的環境中設定 RUNAPI_API_KEY，然後透過 streamable HTTP 將名為 runapi 的 MCP server 註冊至 https://runapi.ai/mcp。Suno 會與所有其他 RunAPI 模型並列，作為可呼叫的音樂工具 — 無需另外接入音樂服務。", "url": "https://runapi.ai/zh-HK/workbuddy-suno#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "向 agent 描述歌曲", "text": "以自然語言告知 WorkBuddy 您的需求並指定模式。使用 auto_lyrics 搭配提示詞讓 AI 撰寫歌詞，使用 exact_lyrics 搭配歌詞／風格／標題填入您自己的文字，或使用 instrumental 搭配風格／標題生成無人聲版本。Agent 會將您的簡介對應至 Suno 工具呼叫。", "url": "https://runapi.ai/zh-HK/workbuddy-suno#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "讓 agent 輪詢並收集音訊", "text": "歌曲生成為非同步，視版本而定需時 30 秒至數分鐘。工作台 agent 輪詢任務直至狀態顯示為 completed，然後將輸出音訊 URL 發佈至對話中 — 您無需自行處理 task_id。", "url": "https://runapi.ai/zh-HK/workbuddy-suno#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "主頁", "item": "https://runapi.ai/zh-HK" }, { "@type": "ListItem", "position": 2, "name": "適用於 WorkBuddy 的 RunAPI Suno", "item": "https://runapi.ai/zh-HK/workbuddy-suno" } ] } ] ```