如何写出更好的 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 一起传入。

Claude 访客：新账户可在 30 天内获得 $1.00 API 赠送额度。每人限领一次，仅用于 API 用量。

WORKBUDDY + SUNO

在 WorkBuddy 中使用 Suno

Suno 从文本提示词或精确歌词生成完整歌曲——人声、乐器和混音。由于 Suno 没有官方公开 API，v4 到 v5.5 各版本通过 RunAPI 提供 API 访问。把 RunAPI 添加为 MCP 服务器一次，WorkBuddy 智能体就会处理异步任务，并把生成好的音频 URL 交回给你。

获取 API Key 阅读文档

一个 MCP 服务器 · 文本生成完整歌曲 · 异步轮询自动完成

通过 runapi MCP 服务器，用 Suno 生成一首歌。

要求：
- 调用 runapi MCP 服务器暴露的 Suno text_to_music 工具。
- 将 model 设为 "suno-v5.5"。
- 将 vocal_mode 设为 "auto_lyrics"，根据我的简介自动写歌词。
- 提示词：一首关于深夜写代码的轻快独立流行歌曲，
  温暖的合成器和原声吉他，女声演唱。
- 该任务为异步任务——持续轮询直到 status 为 "completed"，
  然后把音频 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 服务器

在启动 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

向智能体描述歌曲

用平实的语言告诉 WorkBuddy 你想要什么，并点名模式。auto_lyrics 加提示词让 AI 写歌词，exact_lyrics 加 lyrics/style/title 使用你自己的歌词，instrumental 加 style/title 生成无人声版本。智能体会把你的简介映射到 Suno 工具调用上。

vocal_mode: auto_lyrics

由智能体轮询并取回音频

歌曲生成为异步任务，视版本需要 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 各版本。