Skip to main content
POST

Authorizations

string
wajib
Semua antarmuka memerlukan autentikasi menggunakan Bearer TokenDapatkan API Key:Kunjungi halaman pengelolaan API Key untuk mendapatkan API Key AndaSaat digunakan, tambahkan pada header permintaan:

Body

string
default:"suno"
Model audio. Saat ini kirim suno (jika tidak dikirim, default suno).
string
default:"v6"
Versi publik: v6 / v6-wild / v6-mini; default saat dihilangkan: v6.
string
wajib
Deskripsi teks efek suara. Jika tidak ada, 400 langsung dikembalikan saat pengiriman (tanpa penagihan). Sebaiknya gunakan prompt dalam bahasa Inggris untuk hasil terbaik.
string
default:"one-shot"
Tipe efek suara: one-shot (default, sekali picu) / loop (dapat diulang).
integer
Tempo, 1300; nilai di luar rentang langsung mengembalikan 400 saat pengiriman.
string
Enum tangga nada: nada mayor C / C# / D / D# / E / F / F# / G / G# / A / A# / B; nada minor menambahkan m (Cm / C#m / … / Bm). Hanya notasi kres (#) yang didukung; notasi mol (Db / Eb, dll.) dan B# mengembalikan 400 (key param error).
string
Format audio keluaran: mp3 / m4a / wav.
API ini tidak mendukung model kustom, Max, variety, atau durasi target.
Ambil hasil: API ini membuat tugas asinkron. Polling GET /v1/music/tasks/{task_id} setiap 3–5 detik hingga status menjadi completed atau failed. Saat diproses, status dapat berupa pending atau processing; progress adalah bilangan 0–100 tetapi tidak dijamin berubah dalam interval tetap. Setelah selesai, baca audio_url dari data.result.music[]. Jika gagal, alasannya ada di data.error.message dan dana yang dipotong dikembalikan otomatis.

Response

integer
Kode status respons
array
Array data yang dikembalikan