Suno API 非官方Python接口使用指南

Suno API 非官方Python接口使用指南

【免费下载链接】Suno-API This is an unofficial Suno API based on Python and FastAPI. It currently supports generating songs, lyrics, etc. It comes with a built-in token maintenance and keep-alive feature, so you don't have to worry about the token expiring. 项目地址: https://gitcode.com/GitHub_Trending/su/Suno-API

Suno API 是一个基于 Python 和 FastAPI 的非官方 Suno AI 音乐生成服务接口，支持生成歌曲、歌词等功能。该项目自带 token 维护与保活功能，无需担心 token 过期问题。

项目特点

• 自动 token 维护与保活：系统会自动维护会话 token 并保持活跃状态
• 全异步架构：基于异步设计，响应速度快，适合后期功能扩展
• 代码简洁易维护：代码结构清晰，便于二次开发和定制

环境配置

安装依赖

首先安装项目所需的 Python 依赖包：

pip3 install -r requirements.txt

配置环境变量

创建 .env 文件并配置必要的认证信息：

1. 复制 .env.example 文件并重命名为 .env
2. 从浏览器获取 session_id 和 cookie 信息并填入配置文件
3. 系统会自动维护这些认证信息的有效性

快速启动

本地运行

使用 uvicorn 启动 FastAPI 服务：

uvicorn main:app --host 0.0.0.0 --port 8000 --reload

Docker 部署

使用 Docker Compose 快速部署：

docker compose build && docker compose up

API 接口说明

生成音乐

使用自定义模式生成音乐：

curl -X POST http://localhost:8000/generate \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "歌曲歌词内容",
    "mv": "chirp-v3-0",
    "title": "歌曲标题",
    "tags": "音乐风格",
    "negative_tags": "排除风格"
  }'

生成歌词

生成指定主题的歌词：

curl -X POST http://localhost:8000/generate/lyrics/ \
  -H "Content-Type: application/json" \
  -d '{"prompt": "歌词主题描述"}'

查询作品信息

获取特定作品详细信息：

curl -X GET http://localhost:8000/feed/{作品ID}

获取账户额度

查询账户剩余额度和使用情况：

curl -X GET http://localhost:8000/get_credits

接口文档

服务启动后，访问 /docs 路径可以查看完整的 API 文档和交互式测试界面：

技术架构

项目采用现代化的技术栈：

• FastAPI：高性能 Python Web 框架
• 异步处理：全异步架构提升并发性能
• 自动认证：内置 token 维护机制
• Docker 支持：容器化部署方案

开发建议

1. 环境配置：确保正确配置环境变量中的认证信息
2. 异步编程：充分利用异步特性提升性能
3. 错误处理：合理处理 API 调用中的异常情况
4. 扩展开发：基于现有架构可以轻松添加新功能

该项目为开发者提供了便捷的 Suno AI 音乐生成服务接入方案，适合集成到各种应用程序中实现音乐生成功能。

【免费下载链接】Suno-API This is an unofficial Suno API based on Python and FastAPI. It currently supports generating songs, lyrics, etc. It comes with a built-in token maintenance and keep-alive feature, so you don't have to worry about the token expiring. 项目地址: https://gitcode.com/GitHub_Trending/su/Suno-API