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.

POST/v1/music
ModelIDHarga per lagu

Buat lagu

import os
import time
import requests
api = "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 dengan style tanpa lyrics.

Hasilnya

Setiap item dalam tracks
indexnumber
Urutan take, dimulai dari 1. Gunakan sebagai track saat 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

GET/v1/music/{id}/content?track=1

Streaming dalam format MP3. Lagu disimpan selama 30 hari.

Daftar lagu Anda

GET/v1/music

Terbaru 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

Suno tidak memiliki API publik sendiri, dan Zurelay tidak berafiliasi dengan Suno. Permintaan dijalankan pada kapasitas pihak ketiga, sehingga ketersediaan dapat berubah. Periksa ketentuan Suno sebelum memublikasikan atau menjual lagu.

Ada pertanyaan, atau ada yang kurang? Tanyakan kepada tim dukungan kami dan kami akan menjawab lewat email, biasanya dalam satu menit.