← 所有文章

Suno API 与 MCP：如何把音乐生成接入你的项目

从抽象声源扩散的发声波

Suno 是一系列音乐生成模型。NeuralSpace 提供以下模型：Suno V5.5, Suno V5, Suno V4.5+, Suno V4.5, Suno V4。它们都通过同一个公开 API 运行，并为 AI 智能体提供了现成的 MCP 服务器。密钥在 API 密钥页面 签发。本文介绍它的能力、请求示例和接入方法。

Suno 能做什么

Suno 根据文本描述生成音乐，通常每次生成两首曲目。提供 V5.5、V5、V4.5+、V4.5 和 V4 版本。有普通描述模式和带歌词、风格、标题的自定义模式。生成是异步的：通过 GET /v1/music/generations/:id 轮询状态。

API 端点

请求发送到 POST /v1/music/generations。示例：{"model": "V5_5", "prompt": "一段平静的背景纯音乐", "instrumental": true}。授权使用请求头 x-api-key 中的 API key。可用的模型 id：V5_5, V5, V4_5PLUS, V4_5, V4。

呈圆形扩散的发声波

MCP 工具

NeuralSpace 的 MCP 服务器位于 POST /mcp（Streamable HTTP）。要使用 Suno，智能体调用工具：generate_music, check_music, list_models, get_balance。这让 Claude Code、Cursor 等 MCP 客户端能直接使用网站模型。

如何接入

在 NeuralSpace 注册，打开 API 密钥页面 并创建 nsk-… 格式的密钥。然后在请求头或 MCP 客户端设置中传入它。完整文档见 /v1/docs 页面。

常见问题

每次生成会得到几首曲目？

通常每次生成两首曲目。

可以提供歌词吗？

可以，在自定义模式中传入歌词、风格和标题。

请求是什么格式？

POST /v1/music/generations，带 model 和 prompt 字段。