Langsung ke konten utama
POST

Authorizations

Authorization
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

model
string
default:"suno"
Model audio. Saat ini kirim suno (jika tidak dikirim, default suno).
version
string
default:"v5.5"
Versi pembuatan: hanya v5 / v5.5; jika tidak dikirim, default v5.5.
prompt
string
wajib
Deskripsi teks efek suara (dipetakan ke sound pihak hulu). Jika tidak ada, 400 langsung dikembalikan saat pengiriman (tanpa memanggil pihak hulu, tanpa penagihan).
type
string
default:"one-shot"
Tipe efek suara: one-shot (default, sekali picu) / loop (dapat diulang).
bpm
integer
Tempo, 1300; nilai di luar rentang langsung mengembalikan 400 saat pengiriman.
key
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).
Mengambil hasil: Antarmuka ini adalah tugas asinkron. Setelah pengiriman, Anda mendapatkan task_id; lakukan polling GET /v1/music/tasks/{task_id} dengan interval 3–5 detik hingga status menjadi completed atau failed (selama pembuatan, status adalah pending dan progress berjalan: antre 10 → siap 50 → selesai 100). Setelah selesai, ambil audio_url dari data.result.music[]. Jika gagal, data.error.message berisi alasannya dan kuota yang dipotong di muka otomatis dikembalikan.

Response

code
integer
Kode status respons
data
array
Array data yang dikembalikan