企业官网建设流程全解析

Suno AI API 快速上手指南：5分钟部署 AI 音乐生成服务

【免费下载链接】Suno-APICreate Music in Seconds with SunoAPI.项目地址: https://gitcode.com/GitHub_Trending/su/Suno-API

Suno AI API 是一个把 Suno 音乐生成能力变成标准 REST 接口的开源项目。它基于 Python 和 FastAPI 开发，MIT 协议，支持一键生成歌曲和歌词，还自带 token 自动保活。这篇文章带你走完从部署到实测的完整流程。

一、项目速览

Suno AI API 是一个社区开源项目，把 Suno 网页端里的音乐能力暴露成了标准 API，核心是 Python + FastAPI，采用 MIT 协议。由于 Suno 至今没有开放官方 API，这个项目通过封装网页端接口，解决了"没法用程序调用音乐生成"的痛点。它最亮眼的地方是 token 自动刷新与保活——你只需提供一次凭证，服务会自己帮你维持登录状态。想在自己机器人或应用里塞一个"生成一首歌"的能力，它算是目前门槛最低的选择之一。

二、5分钟跑起来

整个过程就四步，前提只有一个：你有一个 Suno 账号，并且能在浏览器里正常登录 suno.com。

1. 把仓库克隆到本地并进入目录，代码来源就到这里了：

git clone https://gitcode.com/GitHub_Trending/su/Suno-API cd Suno-API

2. 仓库里只有.env.example模板，把它复制为.env并填写三个变量。SESSION_ID 和 COOKIE 都从浏览器开发者工具里拿，这一步最关键：

cp .env.example .env

BASE_URL=https://studio-api.suno.ai SESSION_ID=粘贴你的session id COOKIE=粘贴你的cookie

3. 安装依赖。依赖清单在 requirements.txt 里，一条命令装完（建议 Python 3.10+）：

pip3 install -r requirements.txt

4. 启动服务，本地直接跑或 Docker 一键起都行：

uvicorn main:app

docker compose build && docker compose up

验证方法：浏览器打开http://localhost:8000/docs，看到 Swagger 接口列表说明服务已起；再调一下 GET/get_credits，返回带credits_left字段的 JSON，说明 cookie 生效，跑通了。

三、核心能力实测

服务默认监听 8000 端口，接口都是标准 JSON。挑三个最常用的：

一句话描述生成整首歌

只有一句心情描述、不想写歌词时，打/generate/description-mode：

curl -X POST http://localhost:8000/generate/description-mode \ -H "Content-Type: application/json" \ -d '{"gpt_description_prompt": "一首轻快欢快的春日流行歌"}'

响应里会返回任务 id。音乐生成是异步的，拿这个 id 轮询 GET/feed/{aid}，等audio_url非空时歌就好了，直接下载 mp3。这个能力适合做聊天机器人、小程序里的"一句话出歌"功能。

自带歌词，交给它谱曲

已经有歌词就打/generate，同时传 prompt（歌词）、title、tags（风格）等字段：

curl -X POST http://localhost:8000/generate \ -H "Content-Type: application/json" \ -d '{"prompt": "你的歌词", "title": "春日早晨", "tags": "轻快 流行", "negative_tags": "", "mv": "chirp-v3-0"}'

tags 可以叠加多个风格词，negative_tags 用来排除不想要的。这条路线适合有固定风格、需要批量产出的创作者。

AI 写歌词，再配上曲

连歌词都不想写，就先让/generate/lyrics/起草一版：

curl -X POST http://localhost:8000/generate/lyrics/ \ -d '{"prompt": "写一首关于雨夜离别的歌"}'

返回的 id 拿去 GET/lyrics/{lid}拿到完整歌词，再塞给/generate完成配曲。这个"先词后曲"的组合，是做短视频 BGM 和播客片头曲最常用的流程。

四、避坑指南

⚠️坑一：启动后一调就 500

现象：服务起得好好的，每个接口一调就是 500 或鉴权错误。原因：.env里的 SESSION_ID 或 COOKIE 没填、或复制时丢了字符，这两个是唯一的凭证。解法：浏览器重新登录 suno.com，从开发者工具复制新鲜的 session_id 和 cookie，填回.env再重启。

坑二：调了 generate 却等不到音乐

现象：生成接口返回成功，但一直拿不到音频。原因：音乐生成是异步任务，模型需要时间编曲。解法：用响应里的任务 id 轮询 GET/feed/{aid}，audio_url为空说明还在生成，非空即可取下载链接，通常几十秒内完成。

坑三：8000 端口冲突

现象：docker compose up报端口被占用。原因：8000 是默认端口，不少本地开发工具也在用它。解法：用uvicorn main:app --port 8080启动，把 curl 里的端口同步改成 8080 即可，不用动任何配置文件。

五、延伸方向

跑通基础服务后，有两个方向很好拓展。一是接入 GPTs 之类的 Agent：接口是标准 REST，CORS 全开，在对话里直接调用生成并播放音乐，相当于给聊天框装了一位"AI 音乐总监"。二是把/get_credits接进自己的后台，它返回credits_left和月度用量，方便做额度提醒与配额管理。

接口全集可查仓库里的 README.md，请求与响应字段定义都在 schemas.py 里。

🎵 填好 cookie，启动服务，5 分钟后你就能听到第一首 AI 生成的歌。

【免费下载链接】Suno-APICreate Music in Seconds with SunoAPI.项目地址: https://gitcode.com/GitHub_Trending/su/Suno-API