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).
array
wajib
Array berisi 1–4 URL audio yang dapat diakses secara publik.
string
default:"v5.5"
Versi pembuatan: v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, memengaruhi kualitas audio dan penagihan; jika tidak dikirim, default v5.5.
string
Lirik / konten.
string
Judul.
string
Tag gaya.
string
Tag gaya yang dikecualikan.
number
Bobot gaya, 0.001.00.
number
Bobot kreativitas, 0.001.00 (alias weirdness).
number
Bobot audio, 0.001.00.
string
Jenis kelamin vokal: Male / Female.
boolean
true=menulis ulang lirik yang diberikan secara kreatif.
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 (pembuatan musik biasanya 30–120 detik; 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

integer
Kode status respons
array
Array data yang dikembalikan