Suno-API 项目安装和配置指南

2026-01-25 06:18:16作者：谭伦延

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

1、项目的基础介绍和主要的编程语言

Suno-API 是一个基于 Python 和 FastAPI 的开源项目，旨在帮助用户在几秒钟内创建音乐、歌词等内容。该项目提供了一个非官方的 API，支持自动维护和保持令牌活动，确保用户无需担心令牌过期问题。Suno-API 的主要编程语言是 Python，它具有简单易用的代码结构，方便用户进行二次开发和维护。

2、项目使用的关键技术和框架

Suno-API 项目主要使用了以下关键技术和框架：

Python：作为主要的编程语言，Python 提供了强大的库和工具支持。
FastAPI：一个现代、快速（高性能）的 Web 框架，用于构建 API，基于 Python 3.7+ 的类型提示。
Docker：用于容器化部署，简化项目的安装和配置过程。
uvicorn：一个快速的 ASGI 服务器，用于运行 FastAPI 应用程序。

3、项目安装和配置的准备工作和详细的安装步骤

准备工作

在开始安装和配置 Suno-API 项目之前，请确保您的系统已经安装了以下软件和工具：

Python 3.7 或更高版本：项目依赖于 Python 3.7 或更高版本。
Docker 和 Docker Compose：用于容器化部署。
Git：用于克隆项目代码。

安装步骤

克隆项目代码

首先，使用 Git 克隆 Suno-API 项目的代码库到本地：
```
git clone https://github.com/SunoAI-API/Suno-API.git
cd Suno-API
```
配置环境变量

进入项目目录后，复制 .env.example 文件并重命名为 .env，然后编辑 .env 文件，填写 session_id 和 cookie。这些信息最初可以从浏览器中获取，项目会自动保持这些令牌的活动状态。
```
cp .env.example .env
nano .env
```
在 .env 文件中填写以下内容：
```
SESSION_ID=your_session_id
COOKIE=your_cookie
```
安装依赖

使用 pip 安装项目所需的依赖包：
```
pip3 install -r requirements.txt
```
运行项目

使用 uvicorn 运行 FastAPI 应用程序：
```
uvicorn main:app --reload
```
或者，如果您更喜欢使用 Docker 进行部署，可以执行以下命令：
```
docker-compose build
docker-compose up
```
访问项目

项目启动后，您可以通过浏览器访问 http://localhost:8000/docs 来查看 API 文档和测试接口。