Musik
Musik
Buat lagu utuh dari deskripsi, atau dari lirik dan gaya musik Anda sendiri. Setiap permintaan menghasilkan 2 versi dengan satu harga, dan biasanya selesai dalam sekitar satu menit.
/v1/musicBuat lagu
import osimport timeimport requestsapi = "https://api.zurelay.com/v1"headers = {"Authorization": f"Bearer {os.environ['ZURELAY_API_KEY']}"}song = requests.post(f"{api}/music", headers=headers, json={ "model": "suno-v6", "prompt": "A cheerful acoustic folk song about morning coffee",}).json()while song["status"] in ("queued", "in_progress"): time.sleep(5) song = requests.get(f"{api}/music/{song['id']}", headers=headers).json()for track in song["tracks"]: print(track["title"], track["url"])Lagu dibuat di latar belakang. POST /v1/music langsung merespons dengan sebuah id; minta hasilnya dengan GET /v1/music/{id} setiap beberapa detik sampai statusnya completed atau failed.
Parameter
Kirim prompt untuk mendeskripsikan lagu, atau tulis sendiri dengan lyrics dan style. Jangan kirim keduanya.
modelstringwajib- ID model musik dari tabel.
promptstring- Seperti apa lagu yang Anda inginkan, maksimal 200 karakter.
lyricsstring- Lirik buatan Anda sendiri, hingga 3,000 karakter. Tandai bagian lagu dengan tag seperti
[Verse]dan[Chorus]. stylestring- Genre, suasana, instrumen, atau suara, maksimal 120 karakter.
exclude_stylestring- Gaya atau instrumen yang ingin dihindari, maksimal 120 karakter.
titlestring- Judul lagu, maksimal 80 karakter.
instrumentalboolean- Tanpa vokal. Berfungsi dengan
prompt, atau denganstyletanpalyrics.
Hasilnya
indexnumber- Urutan take, dimulai dari 1. Gunakan sebagai
tracksaat mengunduh. titlestring- Judul lagu. Model akan membuatkannya jika Anda tidak mengisinya.
duration_secondsnumber- Durasi take.
stylestring- Gaya yang digunakan model, dalam kata-katanya sendiri.
lyricsstring- Lirik yang dinyanyikan. Kosongkan untuk musik instrumental.
urlstring- Tautan ke file MP3, berlaku selama 24 jam. Ambil lagu itu kembali untuk mendapatkan tautan baru.
Unduh sebuah take
/v1/music/{id}/content?track=1Streaming dalam format MP3. Lagu disimpan selama 30 hari.
Daftar lagu Anda
/v1/musicTerbaru lebih dulu. Menerima limit (maksimal 100) dan after (id lagu) untuk menelusuri halamannya.
Perlu diketahui
- Anda hanya dikenai biaya saat lagu berhasil dikirimkan. Jika gagal, tidak ada biaya.
- Permintaan yang menyebut nama artis terkenal, atau memakai lirik milik orang lain, dapat ditolak dengan kode error
content_policy. Sebaiknya deskripsikan saja suaranya. - Panjang lagu bervariasi, biasanya dari kurang dari satu menit hingga sekitar tiga setengah menit. Durasi tidak dapat diatur.
Bukan API resmi Suno
Ada pertanyaan, atau ada yang kurang? Tanyakan kepada tim dukungan kami dan kami akan menjawab lewat email, biasanya dalam satu menit.