Suno AI 音乐生成 API 快速跑通从配置到首次调用的完整指南【免费下载链接】Suno-APICreate Music in Seconds with SunoAPI.项目地址: https://gitcode.com/GitHub_Trending/su/Suno-APISuno-API 是一个把 Suno 音乐生成服务封装成标准 HTTP API 的开源项目让你能用任意语言或工作流直接调用它。本教程带你从环境配置一路走到第一次成功生成歌曲。它解决什么问题Suno 官方没有开放公开 API想在自己的项目里使用它的音乐生成能力过去只能靠浏览器手动点。这个项目把这套手动操作变成了可一行代码调用的服务发一个 prompt 请求拿回歌词或成品歌曲。它用 Python 和 FastAPI 编写MIT 许可证代码非常精简——main.py 定义全部路由utils.py 负责底层请求cookie.py 负责凭证维护。它最有价值的特性是内置 token 保活服务启动后每 5 秒自动续期一次 token你不用操心会话中途过期。从零到跑通的完整搭建流程克隆仓库进入项目目录。git clone https://gitcode.com/GitHub_Trending/su/Suno-API cd Suno-API配置环境文件。把 .env.example 复制为.env填三个值BASE_URL已预置官方接口地址不用动SESSION_ID和COOKIE需要从浏览器获取——登录 Suno 官网后打开开发者工具F12的 Network 面板找到任意一条tokens请求从请求 URL 里复制 session ID从请求头里复制完整 Cookie 字符串。安装依赖项目依赖很少一条 pip 命令即可。pip3 install -r requirements.txt启动服务本地运行监听 8000 端口偏好容器化的话docker compose build docker compose up也可以端口映射定义在 docker-compose.yml。uvicorn main:app启动后在浏览器打开 http://127.0.0.1:8000/docs能看到自动生成的接口文档所有端点和请求体都可以在线调试实战调用示例先调描述模式生成只需给一句描述其余交给模型curl -X POST http://127.0.0.1:8000/generate/description-mode \ -H Content-Type: application/json \ -d {gpt_description_prompt: A Blues song about a person who is feeling happy and optimistic about the future., make_instrumental: false, mv: chirp-v3-0}接口会返回生成任务信息再拿返回的 id 轮询GET /feed/{aid}即可拿到 audio_url下载这个 URL 就是 mp3 成品。想要完全掌控的话用/generate自定义模式传入歌词、标题和风格标签字段定义在 schemas.py歌词生成同样是单次调用POST /generate/lyrics/带上 prompt 即可。可直接复制的完整请求样例见 test.py。常见问题与避坑接口全部返回鉴权错误通常是.env里的SESSION_ID或COOKIE没拷全或者获取凭证后又在浏览器重新登录过旧会话被作废。重新进官网从浏览器再复制一遍然后重启服务。端口 8000 被占用默认端口是 8000被占用时 uvicorn 会直接报 address in use。换用uvicorn main:app --port 8001换端口或释放掉占用进程走 docker compose 的话记得同步改端口映射。生成失败或额度用尽生成消耗的是你 Suno 账号的每日 credits额度不足时请求会失败。随时调用GET /get_credits查看剩余credits_left为 0 就等下一个计费周期。进阶方向与生态联动接入 Agent / 工作流所有端点都是标准 HTTP POST可以直接挂进 GPTs、n8n 等智能体框架作为一个音乐生成工具节点。一个常见玩法是两段式流水线先用/generate/lyrics/让模型写出歌词再喂给/generate谱成歌曲。二次开发代码结构极简单新增接口只需在 main.py 加一个路由、在 utils.py 写请求函数token 由 deps.py 统一注入你只关心业务逻辑。组合内容生产管线test.py 里的轮询取音频、下载逻辑是现成的骨架可以扩展成歌词→歌曲→本地落盘的自动化流程再搭配图像生成类 API一次产出带封面图的完整内容。cookie 配好之后剩下的都是标准 HTTP 调用——这就是这个项目省事的地方。【免费下载链接】Suno-APICreate Music in Seconds with SunoAPI.项目地址: https://gitcode.com/GitHub_Trending/su/Suno-API创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考