ซูโน API
v1.0.7
SunoAI API Library เป็นไคลเอนต์ Python อย่างไม่เป็นทางการสำหรับการโต้ตอบกับโปรแกรมสร้างเพลงของ Suno AI ไลบรารีนี้อำนวยความสะดวกในการสร้างเพลงโดยใช้โมเดล Chirp v3 ของ Suno และรวมฟังก์ชันหลักของ Suno AI ด้วยโปรแกรมดาวน์โหลดเพลงในตัว สามารถปรับใช้เป็น REST API ได้โดยใช้ FastAPI, Local, Docker บนผู้ให้บริการ PaaS เช่น Heroku
- ก่อนที่จะใช้ไลบรารีหรือ REST API คุณต้องลงทะเบียนบนเว็บไซต์ suno.ai และรับคุกกี้ของคุณ ตามที่แสดงในภาพหน้าจอนี้
คุณสามารถค้นหาคุกกี้ได้จาก เครื่องมือสำหรับนักพัฒนาเว็บเบราว์เซอร์ -> แท็บเครือข่าย
เพียงคลิกขวาและเปิดตรวจสอบ ตัวกรอง : _clerk_js_version
ตั้งค่าคุกกี้นี้เป็นตัวแปรสภาพแวดล้อม SUNO_COOKIE หรือเริ่มต้นไลบรารีดังที่แสดงด้านล่าง
from suno import Suno , ModelVersions
client = Suno (
cookie = 'YOUR_COOKIE_HERE' ,
model_version = ModelVersions . CHIRP_V3_5 )ติดตั้งไลบรารีโดยใช้ pip:
pip install SunoAI ตั้งค่า SUNO_COOKIE เป็นตัวแปรสภาพแวดล้อมก่อนปรับใช้ - คำแนะนำ
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() <- กำลังเริ่มต้น
chirp-v3-5 , chirp-v3-0 , chirp-v2-0 ค่าเริ่มต้นคือ chirp-v3-5 - มุมมองรายละเอียด generate()
Clip ที่มีข้อมูลเพลงพร้อม ID 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 ตรวจสอบให้แน่ใจว่าพารามิเตอร์ prompt มีเนื้อเพลงของเพลงที่คุณต้องการสร้าง ในทางกลับกัน หากตั้งค่า is_custom เป็น False ให้ระบุคำอธิบายโดยระบุรายละเอียดสาระสำคัญของเพลงที่คุณต้องการwait_audio เป็น True คำขอจะใช้เวลานานกว่าเนื่องจากรอให้ URL เสียงพร้อม หากไม่ได้ตั้งค่า การตอบสนองจะกลับมาโดยไม่มี audio_url แต่มี ID เสียง ในกรณีเช่นนี้ คุณจะต้องเรียกใช้เมธอด get_songs หรือ get_song หลังจากช่วงเวลาสั้นๆ เพื่อดึงการตอบสนองที่มี audio_url รวมอยู่ด้วย เมื่อกระบวนการสร้างเสร็จสมบูรณ์ get_songs()
Clip ที่แสดงถึงเพลงที่ดึงมา songs = client . get_songs ( song_ids = "123,456" )
print ( songs ) set_visibility()
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()
# 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 เพื่อสร้างเพลง
chirp-v3-5 : รุ่นใหม่ล่าสุด โครงสร้างเพลงดีกว่า ความยาวสูงสุด 4 นาทีchirp-v3-0 : กว้าง อเนกประสงค์ สูงสุด 2 นาที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' )แบบคลิป:
คลาส คลิป สรุปรายละเอียดของแทร็กเพลงที่สร้างโดย Suno AI คุณลักษณะแต่ละรายการของคลาสนี้จะให้ข้อมูลเฉพาะเกี่ยวกับแทร็ก:
โมเดลข้อมูลเครดิต:
คลาส CreditsInfo ให้ข้อมูลเกี่ยวกับยอดเครดิตของผู้ใช้และการใช้งานภายในระบบ Suno AI
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 โดยตรง เครดิตโลโก้ : @rejaul43
โครงการนี้เผยแพร่ภายใต้ใบอนุญาต MIT ใบอนุญาตนี้อนุญาตให้ทุกคนใช้ แก้ไข และแจกจ่ายรหัสอีกครั้ง อย่างไรก็ตาม ไม่มีการรับประกันเกี่ยวกับฟังก์ชันการทำงาน สำหรับรายละเอียดเพิ่มเติม โปรดดูไฟล์ LICENSE ในพื้นที่เก็บข้อมูล
หากคุณพบว่าโปรเจ็กต์นี้มีประโยชน์ อย่าลืมให้โปรเจ็กต์นี้บน GitHub สิ่งนี้ช่วยให้ผู้อื่นค้นพบและใช้โปรเจ็กต์นี้ได้เช่นกัน! -
เข้าร่วมช่องโทรเลขของเรา
หากคุณมีคำถาม ข้อเสนอแนะ หรือเพียงต้องการทักทาย คุณสามารถติดต่อเราได้:
? สร้างด้วย ? โดยนักพัฒนารายเดียว
