如何 5 分钟跑通 Suno 音乐生成 API：新手部署与接口调用全解
【免费下载链接】Suno-APICreate Music in Seconds with SunoAPI.项目地址: https://gitcode.com/GitHub_Trending/su/Suno-API
你在做一个视频工具，每次要给视频配 BGM 都得手动去 Suno 网页上生成——官方没开放接口，自动化流程卡死了。Suno-API是一个基于 Python 和 FastAPI 的非官方Suno 音乐生成 API，通过 RESTful 接口生成歌曲和歌词，token 自动保活，部署完就能长期用。全程只需要四步：克隆代码、填 .env、启动服务、调接口，约 5 分钟就能跑起来。
跑起来：克隆、配置、启动服务
部署路径很短：克隆 → 装依赖 → 填 .env → 启动。
git clone https://gitcode.com/GitHub_Trending/su/Suno-API cd Suno-APIpip3 install -r requirements.txt配置放在.env（把.env.example复制一份改名即可），一共 3 个字段：
| 字段 | 填什么 | 从哪拿 |
|---|---|---|
| BASE_URL | Suno 官方接口地址 | 默认已填好，一般不用改 |
| SESSION_ID | 会话 ID | 浏览器开发者工具请求 URL 里的会话 ID 段 |
| COOKIE | 完整 cookie 字符串 | 开发者工具请求头里的 Cookie 整段 |
改名后的.env内容大概长这样：
BASE_URL=https://studio-api.suno.ai SESSION_ID=sess_XXXXXXXX COOKIE=你的完整cookie字符串下图是浏览器开发者工具里获取这两个值的界面，图中圈出的就是 session_id 和 cookie 字段的位置：
填好后直接启动：
uvicorn main:app --host 0.0.0.0 --port 8000习惯容器化的话一行命令搞定：docker compose build && docker compose up，会自动读取同目录下的.env。
能做什么
服务起来后打开127.0.0.1:8000/docs，会看到自动生成的接口文档页。下图就是全部接口的清单，可以直接当调用速查用：
核心能力可以归成三类：
- 🎵音乐生成：
/generate是自定义模式，能指定歌词、模型版本、风格标签，适合需要精确控制曲风的场景；/generate/description-mode是描述模式，一句"一段放松的 lo-fi"这种自然语言描述就能出歌。 - 📝歌词创作：
/generate/lyrics/提交 prompt 后，再用/lyrics/{lid}查询结果，适合先写词、再把词送进歌曲生成的工作流。 - 🔎作品与账户查询：
/feed/{aid}查询某次生成任务的歌曲列表，/get_credits看剩余额度、计费周期和月度用量。
参数细节不展开，完整字段定义看文档页或 schemas.py 里的模型定义。
让它更稳
服务跑一段时间后你可能会遇到几个典型症状，对应三个调整方向：
- 🔧并发高了响应变慢→
utils.py里的 fetch 函数每次都新建 aiohttp 会话 → 改成复用共享连接池并给请求加timeout→ 减少重复建连开销，吞吐提升。 - 响应里偶尔出现错误字符串→ fetch 目前把异常吞掉后直接返回一段错误文本，下游业务分不清正常数据和报错 → 加一层重试和结构化错误返回，或在你的业务层做判断 → 监控告警更可靠。
- 日志被保活刷满→
cookie.py的保活循环每 5 秒刷一次 token，fetch 里还有 print 调试输出 → 把那条 print 注释掉 → 服务安静很多。
三处改动都是几行级别的事，对照源码看一眼就能改。
踩过的坑
- 401 或 token 失效：
.env里的 SESSION_ID 和 COOKIE 对不上，或 cookie 被手动清掉了——重新从浏览器开发者工具抓一遍覆盖进去，保活机制之后会自动维护。 - 响应返回 An error occurred 字符串：这是
utils.py的 fetch 函数把网络异常吞掉了——检查网络环境，确认能访问BASE_URL指向的官方接口。 - 启动报端口占用：8000 被其他服务占了——杀掉旧进程，或者换
--port换个端口。 - Docker 容器起不来：
.env没放好或字段为空，cookie.py启动时读不到环境变量会直接报错——对照三个字段逐个检查。 - 接口 500：看响应里的 detail，多数是 token 或参数问题——建议先调
/get_credits确认账户状态正常。
写在最后
Suno-API 适合需要 AI 配乐或歌词的个人项目、内部工具和演示 demo，非官方接口不建议直接扛高并发的商业生产流量。跑通之后可以照着 main.py 和utils.py的分层，把它包进你自己的业务服务里。现在就去生成你的第一首歌吧。
【免费下载链接】Suno-APICreate Music in Seconds with SunoAPI.项目地址: https://gitcode.com/GitHub_Trending/su/Suno-API
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
