--- title: 通过 RunAPI 在 WorkBuddy 中使用 Suno — 音乐 MCP 指南 | RunAPI description: 通过 RunAPI MCP 服务器在 WorkBuddy 中用 Suno v4 到 v5.5 生成歌曲。一个密钥、多种人声模式，异步轮询由工作台智能体自动完成。 url: https://runapi.ai/zh-CN/workbuddy-suno.md canonical: https://runapi.ai/zh-CN/workbuddy-suno locale: zh-CN 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-CN/workbuddy-suno > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 Suno Suno 从文本提示词或精确歌词生成完整歌曲——人声、乐器和混音。由于 Suno 没有官方公开 API，v4 到 v5.5 各版本通过 RunAPI 提供 API 访问。把 RunAPI 添加为 MCP 服务器一次，WorkBuddy 智能体就会处理异步任务，并把生成好的音频 URL 交回给你。 - [获取 API Key](https://runapi.ai/zh-CN/login) - [阅读文档](https://runapi.ai/zh-CN/docs/guides) 一个 MCP 服务器 · 文本生成完整歌曲 · 异步轮询自动完成 ### Prompt ```text 通过 runapi MCP 服务器，用 Suno 生成一首歌。 要求： - 调用 runapi MCP 服务器暴露的 Suno text_to_music 工具。 - 将 model 设为 "suno-v5.5"。 - 将 vocal_mode 设为 "auto_lyrics"，根据我的简介自动写歌词。 - 提示词：一首关于深夜写代码的轻快独立流行歌曲， 温暖的合成器和原声吉他，女声演唱。 - 该任务为异步任务——持续轮询直到 status 为 "completed"， 然后把音频 URL 给我。 ``` ### MCP 配置 ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### Response ```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 服务器** - 在启动 WorkBuddy 的环境中设置 RUNAPI_API_KEY，然后注册一个名为 runapi 的 MCP 服务器，通过 streamable HTTP 指向 https://runapi.ai/mcp。Suno 会和其他所有 RunAPI 模型一样，作为可调用的音乐工具出现——无需接入单独的音乐服务。 `export RUNAPI_API_KEY=runapi_xxx # MCP 服务器: runapi → https://runapi.ai/mcp ` 2. **向智能体描述歌曲** - 用平实的语言告诉 WorkBuddy 你想要什么，并点名模式。auto_lyrics 加提示词让 AI 写歌词，exact_lyrics 加 lyrics/style/title 使用你自己的歌词，instrumental 加 style/title 生成无人声版本。智能体会把你的简介映射到 Suno 工具调用上。 `vocal_mode: auto_lyrics` 3. **由智能体轮询并取回音频** - 歌曲生成为异步任务，视版本需要 30 秒到几分钟。工作台智能体会持续轮询任务直到 status 为 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（你提供 lyrics/style/title）或 instrumental（无人声，需要 style/title）。 | | `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 服务器调用它，工作台智能体用与聊天和图片相同的密钥即可编程访问 v4 至 v5.5 各版本。 ## Suno 使用场景 - **YouTube 与社交媒体背景音乐** - 向工作台智能体描述情绪和曲风，即可生成原创背景音乐。无授权费，无版权问题——曲目是为你的内容全新生成的，音频 URL 直接回到 WorkBuddy。 - **将歌词变为完整歌曲** - 词作者可以把歌词粘贴进 WorkBuddy，要求使用 exact_lyrics 模式并附上风格描述，听到歌词被演唱为完整歌曲——在进录音棚前就拿到制作级小样。 - **播客片头与片尾** - 通过指定曲风、情绪和时长，创作与播客基调匹配的纯音乐片头和片尾。让智能体在一次对话中生成多个版本，挑选最合适的。 ## Suno + WorkBuddy 常见问题 ### 如何写出更好的 Suno 提示词，得到想要的曲风和风格？ 在给 WorkBuddy 的简介中具体说明曲风、情绪、节奏和配器。例如"轻快的 120 BPM 独立流行，原声吉他加温暖合成器"就比"一首欢快的歌"效果好得多。可以让智能体传入 negative_tags 来排除不想要的元素，例如 heavy metal 或 screaming。 ### 我应该使用哪个 Suno 版本——v4、v5 还是 v5.5？ suno-v5.5 是最新版本，产出质量最高，人声更清晰、混音更好。suno-v4 和 suno-v4.5 更便宜、更快，适合草稿迭代。所有版本都在同一个 runapi MCP 服务器背后，切换版本只需在提示词里换个名字。 ### 在 WorkBuddy 中需要我自己轮询任务吗？ 不需要。Suno 任务是异步的，但任务生命周期由工作台智能体处理——它通过 MCP 工具创建任务，持续轮询直到 status 为 completed，再把音频 URL 发回对话中。你只需描述歌曲，然后等待即可。 ### RunAPI 是否提供官方 Suno API？ Suno 不提供公开 API。RunAPI 通过与所有其他 RunAPI 模型相同的 API 密钥和任务生命周期，提供对 Suno v4 到 v5.5 的编程访问。无需 Suno 账号或单独凭证。 ### 我能控制人声性别和风格权重吗？ 可以。将 vocal_gender 设为 male 或 female，用 negative_tags 排除不想要的风格。如需更精细的控制，可通过 personas 端点创建一个 persona，并将返回的 persona_id 连同设为 voice 或 style 的 persona_type 一起传入。 - [WorkBuddy 配置指南 →](https://runapi.ai/zh-CN/workbuddy.md) - 尚未连接？请从 WorkBuddy 的 RunAPI MCP 配置指南开始。 - [Suno 模型 →](https://runapi.ai/zh-CN/models/suno.md) - 查看所有 Suno 版本、定价和可用端点。 ## 立即在 WorkBuddy 中试用 Suno。 免费获取 RunAPI 密钥，在 WorkBuddy 中添加 MCP 服务器，描述一首歌——工作台智能体会返回一首包含人声、乐器和混音的完整曲目。 [浏览模型 →](https://runapi.ai/zh-CN/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-CN/.md) ### 产品 - [模型目录](https://runapi.ai/zh-CN/models.md) - [定价](https://runapi.ai/zh-CN/pricing.md) - [提供方](https://runapi.ai/zh-CN/models#all-models) ### 开发者 - [文档](https://runapi.ai/zh-CN/docs/guides) - [SDK](https://runapi.ai/zh-CN/sdk.md) - [CLI](https://runapi.ai/zh-CN/cli.md) - [MCP Server](https://runapi.ai/zh-CN/mcp.md) - [x402](https://runapi.ai/zh-CN/x402.md) ### 指南 - [Claude Code 与 Cursor](https://runapi.ai/zh-CN/claude-code-vs-cursor.md) - [Cursor API 设置](https://runapi.ai/zh-CN/cursor-api-setup.md) - [RunAPI 与 OpenRouter](https://runapi.ai/zh-CN/openrouter-alternative.md) ### 公司 - [企业版](https://runapi.ai/zh-CN/contact.md) - [联系](https://runapi.ai/zh-CN/contact.md) ### 法律 - [服务条款](https://runapi.ai/zh-CN/terms.md) - [隐私政策](https://runapi.ai/zh-CN/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-CN/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-CNicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "SoftwareApplication", "name": "适用于 WorkBuddy 的 RunAPI Suno", "applicationCategory": "DeveloperApplication", "description": "通过 RunAPI MCP 服务器在 WorkBuddy 中用 Suno v4 到 v5.5 生成歌曲。一个密钥、多种人声模式，异步轮询由工作台智能体自动完成。", "url": "https://runapi.ai/zh-CN/workbuddy-suno" }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "如何写出更好的 Suno 提示词，得到想要的曲风和风格？", "acceptedAnswer": { "@type": "Answer", "text": "在给 WorkBuddy 的简介中具体说明曲风、情绪、节奏和配器。例如\"轻快的 120 BPM 独立流行，原声吉他加温暖合成器\"就比\"一首欢快的歌\"效果好得多。可以让智能体传入 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 服务器背后，切换版本只需在提示词里换个名字。" } }, { "@type": "Question", "name": "在 WorkBuddy 中需要我自己轮询任务吗？", "acceptedAnswer": { "@type": "Answer", "text": "不需要。Suno 任务是异步的，但任务生命周期由工作台智能体处理——它通过 MCP 工具创建任务，持续轮询直到 status 为 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 端点创建一个 persona，并将返回的 persona_id 连同设为 voice 或 style 的 persona_type 一起传入。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "HowTo", "name": "如何通过 RunAPI 在 WorkBuddy 中使用 Suno", "description": "在 WorkBuddy 中将 RunAPI 添加为 MCP 服务器，向工作台智能体描述你想要的歌曲，由它运行异步 Suno 任务并返回生成好的音频 URL。", "step": [ { "@type": "HowToStep", "position": 1, "name": "将 RunAPI 添加为 MCP 服务器", "text": "在启动 WorkBuddy 的环境中设置 RUNAPI_API_KEY，然后注册一个名为 runapi 的 MCP 服务器，通过 streamable HTTP 指向 https://runapi.ai/mcp。Suno 会和其他所有 RunAPI 模型一样，作为可调用的音乐工具出现——无需接入单独的音乐服务。", "url": "https://runapi.ai/zh-CN/workbuddy-suno#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "向智能体描述歌曲", "text": "用平实的语言告诉 WorkBuddy 你想要什么，并点名模式。auto_lyrics 加提示词让 AI 写歌词，exact_lyrics 加 lyrics/style/title 使用你自己的歌词，instrumental 加 style/title 生成无人声版本。智能体会把你的简介映射到 Suno 工具调用上。", "url": "https://runapi.ai/zh-CN/workbuddy-suno#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "由智能体轮询并取回音频", "text": "歌曲生成为异步任务，视版本需要 30 秒到几分钟。工作台智能体会持续轮询任务直到 status 为 completed，然后把输出音频 URL 发回对话中——你自己完全不用碰 task_id。", "url": "https://runapi.ai/zh-CN/workbuddy-suno#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "首页", "item": "https://runapi.ai/zh-CN" }, { "@type": "ListItem", "position": 2, "name": "适用于 WorkBuddy 的 RunAPI Suno", "item": "https://runapi.ai/zh-CN/workbuddy-suno" } ] } ] ```