Suno AI API

使用 API 调用 Suno.ai 的音乐生成 AI，并轻松将其集成到 GPTs 等智能体（Agents）中。 👉 我们更新速度很快，欢迎点亮 Star。

English | 简体中文 | русский | 演示地址 | 文档 | 部署到 Vercel

🔥 查看我的新项目：Linkly-ai-cli: 专为 AI Agents 构建的文档搜索引擎 CLI

简介

Suno 是一项令人惊叹的 AI 音乐服务。虽然官方 API 尚未发布，但我们迫不及待地想将其功能集成到其他地方。

我们发现许多用户有类似的需求，因此决定将本项目开源，希望你会喜欢。

此实现使用了付费的 2Captcha 服务（又称 ruCaptcha）来自动解决 hCaptcha 挑战，并未依赖任何现有的闭源付费 Suno API 实现。

演示

我们部署了一个绑定了免费 Suno 账户的示例，因此它有每日使用限制，但你可以通过它查看运行效果： suno.gcui.ai

功能特点

• 完美实现了 suno.ai 的创建 API。
• 自动保持账号活跃。
• 使用 2Captcha 和 Playwright 配合 rebrowser-patches 自动解决验证码（CAPTCHA）。
• 兼容 OpenAI 的 /v1/chat/completions API 格式。
• 支持自定义模式（Custom Mode）。
• 支持一键部署到 Vercel 和 Docker。
• 除了标准 API 外，还适配了 GPTs 和 Coze 等 Agent 平台的 API Schema，因此你可以将其作为 LLM 的工具/插件/Action 使用，并集成到任何 AI Agent 中。
• 宽松的开源许可，允许你自由集成和修改。

快速开始

1. 获取你的 Suno 账号 Cookie

1. 使用浏览器前往 suno.com/create。
2. 打开浏览器控制台：按下 F12 或打开“开发者工具”。
3. 导航到 Network（网络）选项卡。
4. 刷新页面。
5. 找到包含 ?__clerk_api_version 关键字的最新请求。
6. 点击该请求并切换到 Header（标头）选项卡。
7. 找到 Cookie 部分，鼠标悬停并复制 Cookie 的值。

2. 注册 2Captcha 并充值余额

2Captcha 是一项付费验证码解决服务，使用人工处理验证码，准确率很高。由于 Suno 频繁触发 hCaptcha 验证，目前没有任何免费方案可以解决，因此这是必需的。

创建 一个新的 2Captcha 账户，充值 余额并获取你的 API Key。

[!NOTE] 如果你位于俄罗斯或白俄罗斯，请使用 ruCaptcha 接口代替 2Captcha。它们是同一服务，但支持来自这些国家的支付方式。

[!TIP] 如果你想尽量减少验证码出现的次数，建议使用 macOS 系统。由于 macOS 在网络爬虫行业使用率较低，通常比 Linux 和 Windows 收到的验证码更少。在 Windows 和 Linux 上运行 suno-api 也可以，但在某些情况下，你可能会遇到大量的验证码验证。

3. 克隆并部署本项目

你可以选择你偏好的部署方式：

部署到 Vercel

本地运行

git clone https://github.com/gcui-art/suno-api.git
cd suno-api
npm install

Docker

[!IMPORTANT] GPU 加速在 Docker 中将被禁用。如果你的 CPU 性能较差，建议本地部署。

或者，你可以使用 Docker Compose。但在运行前，请按照下面的步骤操作。

docker compose build && docker compose up

4. 配置 suno-api

• 如果部署到 Vercel，请在 Vercel 控制面板中添加环境变量。

• 如果是在本地运行，请确保将以下内容添加到你的 .env 文件中：

环境变量

• SUNO_COOKIE — 你在第一步中获取的 Cookie 请求头。
• TWOCAPTCHA_KEY — 你在第二步中获取的 2Captcha API Key。
• BROWSER — 用于解决验证码的浏览器名称，仅支持 chromium 和 firefox。
• BROWSER_GHOST_CURSOR — 使用 ghost-cursor-playwright 模拟平滑的鼠标移动。请注意，它似乎不会产生显著影响。