十分钟部署可用的 Suno 音乐生成 API【免费下载链接】Suno-APICreate Music in Seconds with SunoAPI.项目地址: https://gitcode.com/GitHub_Trending/su/Suno-APISuno-API 是基于 Python 和 FastAPI 的非官方歌曲生成 API 服务面向希望以编程方式调用 Suno 音乐生成能力、把它接入自己应用的开发者。它的核心特点是自带 token 自动维护与保活部署时只需配置一次初始的 session_id 与 cookie服务之后会自行保持令牌有效无需人工刷新。它能为你做什么自定义歌曲生成调用 POST /generate提交歌词、风格标签 tags、负向标签 negative_tags、歌曲标题与模型版本 mv默认 chirp-v3-0逐项控制生成结果。一句话生成调用 POST /generate/description-mode只需用自然语言提交 gpt_description_prompt也可设 make_instrumental 为 true 生成纯器乐曲目。歌词生成与获取POST /generate/lyrics/ 按主题 prompt 生成歌词GET /lyrics/{lid} 再按返回的 id 取回完整歌词。额度查询GET /get_credits 返回账户剩余点数 credits_left、计费周期与月度用量便于安排生成计划。三步完成部署第一步克隆仓库并安装依赖git clone https://gitcode.com/GitHub_Trending/su/Suno-API cd Suno-API pip3 install -r requirements.txt第二步配置初始凭证把.env.example重命名为.env填入 session_id 与 cookie。两者都从浏览器开发者工具中一次获取请求头里可找到 session_id 与完整 cookie 字段粘贴进 .env 即可之后由服务自动保活第三步启动服务uvicorn main:app启动后访问 http://127.0.0.1:8000/docs 查看接口文档。如果偏好容器化部署只需一条命令docker compose build docker compose up它复用同一份 .env 并映射 8000 端口。跑通第一个完整示例服务启动后用描述模式发起一次生成curl -X POST http://127.0.0.1:8000/generate/description-mode \ -H Content-Type: application/json \ -d {gpt_description_prompt: A light indie folk song about a rainy afternoon, make_instrumental: true, mv: chirp-v3-0}响应中会返回曲目 idaid。由于生成需要时间随后轮询 GET /feed/{aid} 查询状态即可。仓库自带的 test.py 给了一个可参考的轮询写法每 30 秒查一次直到响应中 audio_url 字段非空最长等待 90 秒超时。预期的最终结果是 /feed/{aid} 返回数组首元素中 audio_url 即音频下载地址metadata 里包含标题等曲目信息可直接下载播放。服务启动后访问 /docs 路由可在线查看所有接口与参数结构并直接在页面上试调用按需使用各项功能生成歌曲已有完整歌词用自定义模式 POST /generate歌词、标签、标题、模型版本齐全只有一个想法则用描述模式 POST /generate/description-mode。查询曲目拿生成时返回的 id 调用 GET /feed/{aid}audio_url 出现即代表该曲目完成可顺带取到 metadata。管理歌词想先要词再要曲时用 POST /generate/lyrics/ 提交主题生成再按 id 用 GET /lyrics/{lid} 取回。核对额度批量调用前先查 GET /get_credits确认 credits_left 足够避免中途因余额不足失败。实现思路整体是在 Suno 官方后端之上包一层 FastAPI 的轻量封装。所有出站请求使用 aiohttp 全异步处理单实例即可承接并发生成请求而不互相阻塞。令牌维护与请求链路解耦cookie.py 在服务启动时拉起独立后台线程每 5 秒调用官方令牌刷新接口更新 JWT各请求再通过 get_token 依赖注入拿到当前有效令牌令牌过期对调用方透明。请求参数由 schemas.py 中的 Pydantic 模型做校验缺参会在进入上游前就被拦截。使用注意初始凭证需手工获取session_id 与 cookie 必须从浏览器手动取得若账号重新登录或凭证失效服务将无法调用上游需重新配置自动保活只在其有效期内生效。非官方项目本项目直接调用 Suno 官方服务的非公开接口字段与 URL 可能随上游调整而变化生产环境使用需自行评估风险并遵守上游服务条款。生成消耗账户点数每次生成都会消耗绑定 Suno 账户的额度点数不足时生成会失败建议批量调用前先查询 /get_credits。接下来先检查 .env 配置、启动 uvicorn 并确认 /docs 可正常访问再用 GET /get_credits 验证账户可用。跑通后就可以把 /generate 与 /feed 两个接口接进自己的脚本或应用里。【免费下载链接】Suno-APICreate Music in Seconds with SunoAPI.项目地址: https://gitcode.com/GitHub_Trending/su/Suno-API创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
