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
大小
語言簡體中文

相關應用

YouTube dl api

2024-11-05
範例節點 API

2024-11-05
粗糙的蜜蜂例子

2024-11-04
演化API

2024-11-03
加油優惠APP源碼可二開另外底價提供團油API API API

2022-12-06
JDK 5.0 API中文版

2009-06-09

爲您推薦

簡單的 Wav2Lip

其他源碼

v8.3 - GUI for local install + Mac support
YouTube 短褲下載器

其他源碼
HuggingFace 下載加速器

其他源碼
gofile dl

其他源碼
SQL工具

其他源碼

v3.4.0
edx平台

其他源碼
考試時間

其他源碼
反應本機火力基地

其他源碼
rclone_RD

其他源碼

相關資訊全部

網友評論

蘇諾API

尚諾人工智慧API？

Suno AI 的 Python API 庫 — 使用生成式 AI 創建音樂！

特徵

？先決條件

？安裝

部署 - REST API

在 PassS 上部署

部署在本地或VPS上

用法

庫方法

可用的 Suno AI 模型：

圖書館的回應

REST API 使用

？貢獻

學分及其他

⚖️ 許可證

？支持和社區

？支持我

？接觸