Suno AI API

使用 API 调用 Suno.ai 的音乐生成 AI，并轻松将其集成到 GPTs 等智能体中。 👉 项目更新频繁，请点个 Star 支持。

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

简介

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

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

本实现使用了付费的 2Captcha 服务（又名 ruCaptcha）来自动解决 hCaptcha 验证码，且不使用任何现成的闭源付费 Suno API 实现。

Demo

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

功能特点

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

快速开始

1. 获取你的 Suno 账户 Cookie

在浏览器中访问 suno.com/create。
打开浏览器控制台：按下 F12 或进入 开发者工具。
导航到 Network（网络）选项卡。
刷新页面。
找到包含关键字 ?__clerk_api_version 的最新请求。
点击该请求并切换到 Header 选项卡。
定位到 Cookie 部分，将鼠标悬停在上面，复制 Cookie 的值。

get 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 来模拟平滑的鼠标移动。请注意，它似乎并不能显著...