Suno API下载 - Suno API源码下载

苏诺API

其他源码

v1.0.7

下载

尚诺人工智能API？

Suno AI 的 Python API 库 — 使用生成式 AI 创建音乐！

- 可作为 Python 库和 REST API 使用 -

Python库·更新通道

SunoAI API Library是一个非官方的Python客户端，用于与Suno AI的音乐生成器交互。该库有助于使用 Suno 的 Chirp v3 模型生成音乐，并包含 Suno AI 的主要功能和内置音乐下载器。它可以使用 FastAPI、Local、Docker 作为REST API部署在 Heroku 等 PaaS 提供商上。

特征

Python 客户端？ ：轻松与Suno AI互动。
宋代？ ：利用 Chirp v3 模型生成音乐。
通过 ID 检索歌曲信息？ ：访问 Suno AI 上任何歌曲的详细信息。
音乐下载器？ ：内置功能可直接下载 Suno AI 上的任何音乐。
REST API 部署：可作为 REST API 部署在 PasS 平台、VPS 或本地上。
全面的文档：包括详细的示例和使用指南。
Docker 支持吗？ ：使用 Docker 实现容器化部署以实现灵活性。
PaaS 部署☁️：促进在 Heroku 等平台上的部署，以方便访问。

？先决条件

？在使用库或 REST API 之前，您必须在 suno.ai 网站上注册并获取您的 cookie，如此屏幕截图所示。

您可以从 Web 浏览器的开发者工具 -> 网络选项卡中找到 cookie

点击查看-截图

只需右键单击并打开检查。过滤器： _clerk_js_version

将此 cookie 设置为SUNO_COOKIE环境变量或初始化库，如下所示。

 from suno import Suno , ModelVersions
client = Suno (
  cookie = 'YOUR_COOKIE_HERE' ,
  model_version = ModelVersions . CHIRP_V3_5 )

？安装

使用 pip 安装库：

pip install SunoAI

部署 - REST API

在 PassS 上部署

在部署之前将SUNO_COOKIE设置为环境变量。 - 指示

部署在本地或VPS上

 export SUNO_COOKIE= " YOUR_COOKIE_HERE "
git clone [email protected]:Malith-Rukshan/Suno-API.git
pip3 install -r requirements.txt
cd Suno-API
fastapi run api.py --port 8080

？网址：http://127.0.0.1:8080

用法

⚡️快速入门：

 from suno import Suno , ModelVersions
client = Suno (
  cookie = 'YOUR_COOKIE_HERE' ,
  model_version = ModelVersions . CHIRP_V3_5 )

# Generate a song
songs = client . generate ( prompt = "A serene landscape" , is_custom = False , wait_audio = True )

# Download generated songs
for song in songs :
    file_path = client . download ( song = song )
    print ( f"Song downloaded to: { file_path } " )

库方法

Suno() <- 初始化

论据：
- cookie（可选[str]）：可选。 Suno API 的身份验证 cookie。如果未提供，它将使用环境变量 SUNO_COOKIE 中的 cookie。
- model_version (str)：可选。用于生成音频的模型版本。可用型号： chirp-v3-5 、 chirp-v3-0 、 chirp-v2-0默认为chirp-v3-5 。 |详细视图

generate()

论据：
- 提示（str）：歌曲的描述或歌词。
- is_custom (bool)：确定是使用自定义歌词 (True) 还是描述 (False)。
- 标签（可选[str]）：描述所需的语音类型或特征。
- title （可选[str]）：生成的音乐的标题。
- make_instrumental（可选[bool]）：如果为 True，则生成乐器版本。
- wait_audio (bool)：如果 True，则等待音频 URL 准备好。
- model_version（可选[str]）：用于生成音频的模型版本。如果未提供，则默认为初始化值。
返回：包含带有 ID 的歌曲数据的Clip对象列表。

例子：

按描述

 clips = client . generate (
  prompt = "A peaceful melody reflecting a serene landscape" ,
  is_custom = False ,
  wait_audio = True
)
print ( clips )

按歌词 - 定制

 clips = client . generate (
  prompt = "I found a love, for me n Darling, just dive right in and follow my lead n Well, I found a girl, beautiful and sweet n Oh, I never knew you were the someone waiting for me..." ,
  tags = "English men voice" ,
  title = "Perfect by Malith-Rukshan/Suno-API" ,
  make_instrumental = False ,
  is_custom = True ,
  wait_audio = True
)
print ( clips )

✍️使用注意事项：

将is_custom设置为True时，请确保提示参数包含您要生成的歌曲的歌词。相反，如果is_custom设置为False ，请提供描述性提示，详细说明您想要的歌曲的本质。
当wait_audio设置为True时，请求将花费更长的时间来等待音频 URL 准备好。如果未设置，则返回的响应将不带audio_url ，但带有音频ID。在这种情况下，生成过程完成后，您需要在短时间间隔后调用get_songs或get_song方法来检索包含audio_url的响应。

get_songs()

论据：
- Song_ids （可选[str]）：用于获取特定歌曲的歌曲 ID 列表。
返回：代表检索到的歌曲的Clip对象列表。

例子：

 songs = client . get_songs ( song_ids = "123,456" )
print ( songs )

set_visibility()

论据：
- Song_id (str)：要更新的歌曲的 ID。
- is_public (bool)：一个字符串，指示歌曲应该是公开的 (True) 还是私有的 (False)。
返回(bool)：歌曲的公众可见度状态。如果歌曲是公开的，则为 True；如果是私人的，则为 False。
例子：

 response = client . set_visibility ( song_id = "uuid-type-songid-1234" , is_public = False )
print ( response )

get_credits()

返回：作为CreditsInfo对象的当前账单和积分信息。

例子：

 credits_info = client . get_credits ()
print ( credits_info )

download()

论据：
- Song (str | Clip)：要下载的歌曲。这可以是字符串形式的歌曲 ID，也可以是包含歌曲元数据的 Clip 对象。
- path (str)：保存歌曲的目录路径。如果未指定，则默认为“./downloads”。
返回： str - 下载歌曲的完整文件路径。
加薪：
- 类型错误：如果歌曲参数既不是字符串 ID 也不是 Clip 对象。
- 例外：如果由于 URL 无效或网络错误等问题导致下载失败。

例子：

 # Using a song ID
file_path = client . download ( song = "uuid-type-songid-1234" )
print ( f"Song downloaded to: { file_path } " )

# Using a Clip object
clip = client . get_song ( "uuid-type-songid-1234" )
file_path = client . download ( song = clip )
print ( f"Song downloaded to: { file_path } " )

可用的 Suno AI 模型：

Suno AI 提供的用于生成音乐的模型。

CHIRP_V3_5 - chirp-v3-5 ：最新模型，更好的歌曲结构，最长 4 分钟。
CHIRP_V3_0 - chirp-v3-0 ：广泛、通用，最长 2 分钟。
CHIRP_V2_0 - chirp-v2-0 ：复古 Suno 模型，最长 1.3 分钟。

示例如何使用：

 from suno import Suno , ModelVersions

client = Suno ( model_version = ModelVersions . CHIRP_V3_5 )

或者

 from suno import Suno

client = Suno ( model_version = 'chirp-v3-5' )

图书馆的回应

夹子型号：
Clip类封装了 Suno AI 生成的音乐曲目的详细信息。此类的每个属性都提供有关轨道的特定信息：
- id (str)：剪辑的唯一标识符。
- video_url (str)：歌曲视频版本的 URL（如果有）。
- audio_url (str)：可以在其中流式传输或下载音轨的 URL。
- image_url (str)：歌曲图像封面的 URL。
- image_large_url (str)：歌曲图像封面的放大版本的 URL。
- is_video_pending (bool)：指示歌曲的视频是否仍在处理。
- Major_model_version (str)：用于生成歌曲的模型的主要版本。
- model_name (str)：用于生成轨迹的模型的名称。
- 元数据(ClipMetadata)：与剪辑相关的附加元数据，包括标签、提示和其他信息。
- is_liked (bool)：表示该歌曲是否被用户喜欢。
- user_id (str)：创建或请求歌曲的人的用户 ID。
- display_name (str)：与歌曲关联的用户的显示名称。
- handle (str)：用户的句柄或用户名。
- is_handle_updated (bool)：指定用户句柄是否已更新。
- is_trashed (bool)：指示剪辑是否已被标记为已删除。
- 反应（dict）：用户对歌曲的反应（如果有）。
- created_at (str)：指示歌曲创建时间的时间戳。
- status (str)：歌曲的当前状态（例如，正在处理、已完成）。
- title (str)：歌曲的标题。
- play_count (int)：歌曲已播放了多少次。
- upvote_count (int)：歌曲收到的点赞数。
- is_public (bool)：指示歌曲是否可公开访问。
CreditsInfo 模型：
CreditsInfo类提供有关 Suno AI 系统中用户的信用余额和使用情况的信息。
- Credits_left (int)：用户剩余的积分数。
- period (int)：积分的当前计费周期，以某种形式的日期或时间范围表示。
- Monthly_limit (int)：当月分配给用户的积分总数。
- Monthly_usage (int)：用户当月使用的积分数量。

REST API 使用

1. 生成音乐

POST /generate

请求正文：

{
  "prompt" : " A serene melody about the ocean " ,
  "is_custom" : false ,
  "tags" : " relaxing, instrumental " ,
  "title" : " Ocean Waves " ,
  "make_instrumental" : true ,
  "model_version" : " chirp-v3-5 " ,
  "wait_audio" : true
}

回复：

点击查看

[
    {
        "id" : " 124b735f-7fb0-42b9-8b35-761aed65a7f6 " ,
        "video_url" : " " ,
        "audio_url" : " https://audiopipe.suno.ai/item_id=124b735f-7fb0-42b9-8b35-761aed65a7f6 " ,
        "image_url" : " https://cdn1.suno.aiimage_124b735f-7fb0-42b9-8b35-761aed65a7f6.png " ,
        "image_large_url" : " https://cdn1.suno.aiimage_large_124b735f-7fb0-42b9-8b35-761aed65a7f.png " ,
        "is_video_pending" : False,
        "major_model_version" : " v3 " ,
        "model_name" : " chirp-v3 " ,
        "metadata" : {
            "tags" : " English men voice " ,
            "prompt" : " I found a love, for me n Darling,just dive right in and follow mylead n Well, I found a girl, beautiful andsweet n Oh, I never knew you were thesomeone waiting for me nn ′Cause we werejust kids when we fell in love n Not knowingwhat it was n I will not give you up thistime n But darling, just kiss me slow n Yourheart is all I own n And in your eyes,you're holding mine nn Baby, I′m dancing inthe dark n With you between myarms n Barefoot on the grass n Listening toour favourite song n When you said youlooked a mess n I whispered underneath mybreath n But you heard it n Darling, you lookperfect tonight " ,
            "gpt_description_prompt" : None,
            "audio_prompt_id" : None,
            "history" : None,
            "concat_history" : None,
            "type" : " gen " ,
            "duration" : None,
            "refund_credits" : None,
            "stream" : True,
            "error_type" : None,
            "error_message" : None
        },
        "is_liked" : False,
        "user_id" : " 2340653f-32cb-4343-artb-09203ty749e9 " ,
        "display_name" : " Snonymous " ,
        "handle" : " anonymous " ,
        "is_handle_updated" : False,
        "is_trashed" : False,
        "reaction" : None,
        "created_at" : " 2024-05-05T11:54:09.356Z " ,
        "status" : " streaming " ,
        "title" : " Perfect by Malith-Rukshan/Suno-API " ,
        "play_count" : 0 ,
        "upvote_count" : 0 ,
        "is_public" : False
    }
]

2. 检索歌曲

POST /songs

请求正文：

{
  "song_ids" : " uuid-format-1234,4567-abcd "
}

响应：剪辑数组 - 与/generate响应相同

3. 获取一首特定的歌曲

POST /get_song

请求正文：
```
{
  "song_id" : " uuid-song-id "
}
```
响应：仅剪辑响应 - 与/generate响应相同，但仅剪辑

POST /set_visibility

请求正文：

{
  "song_id" : " uuid-song-id " ,
  "is_public" : true
}

回复：
```
{
  "is_public" : true
}
```

4. 检索信用信息

GET /credits

回复：

{
  "credits_left" : 50 ,
  "period" : " 2024-05 " ,
  "monthly_limit" : 100 ,
  "monthly_usage" : 25
}

根据 Suno.ai 的说法，每生成一首歌曲需要消耗 5 个积分，因此每次成功调用总共需要 10 个积分。

？贡献

贡献使开源社区成为学习、启发和创造的绝佳场所。我们非常感谢您所做的任何贡献。

学分及其他

通过该库生成的所有内容和音乐均归功于 Suno AI。这个非官方的 API 提供了一种与 Suno AI 服务交互的便捷方式，但不声明对所生成的音乐的任何所有权或权利。使用Suno AI平台时请遵守Suno AI的服务条款❤️。

该库主要用于教育和开发目的。它旨在增强和简化对 Suno AI 音乐生成功能的访问。如果您喜欢生成的音乐，请考虑直接支持Suno AI。徽标信用：@rejaul43

⚖️ 许可证

该项目是根据 MIT 许可证分发的。该许可证允许每个人使用、修改和重新分发代码。但是，它不对其功能提供任何保证。有关更多详细信息，请参阅存储库中的 LICENSE 文件。

？支持和社区

如果您发现这个项目有帮助，请不要忘记在 GitHub 上给它一个。这也可以帮助其他人找到并使用该项目！？

？支持我

加入我们的 Telegram 频道，

@SingleDevelopers，了解更多精彩项目和更新 ✓
@SunoAPI，针对此项目更新 ✓

？接触

如果您有任何问题、反馈，或者只是想打个招呼，可以联系我：

开发者：@MalithRukshan
支持小组：@Suno_API

?‍ 用 ? 构建由单一开发者

展开

附加信息

版本 v1.0.7
类型其他源码
更新时间 2024-11-16
大小
语言简体中文

苏诺API

尚诺人工智能API？

Suno AI 的 Python API 库 — 使用生成式 AI 创建音乐！

特征

？先决条件

？安装

部署 - REST API

在 PassS 上部署

部署在本地或VPS上

用法

库方法

可用的 Suno AI 模型：

图书馆的回应

REST API 使用

？贡献

学分及其他

⚖️ 许可证

？支持和社区

？支持我

？接触

YouTube dl api

示例节点 API

粗糙的蜜蜂例子

进化API

加油优惠APP源码可二开另外底价提供团油API API API

JDK 5.0 API中文版

实时分割

DOSA

INN箔

RWKV 跑步者

vrcosc 魔法聊天室

支持同伴

涡流

单存储 ODBC 连接器

perlego 下载扩展