Langsung ke konten utama
POST
custom menentukan bidang mana yang berlaku: bidang yang ditulis pada mode yang salah akan diabaikan secara diam-diam oleh upstream (tanpa error). Saat custom=true (mode kustom), prompt (lirik), title, style, negative_tags, auto_lyrics, persona_id, style_weight, weirdness_constraint, dan audio_weight berlaku; saat custom=false (mode inspirasi), prompt digunakan sebagai deskripsi inspirasi, sedangkan title/style dan bidang kustom di atas diabaikan. vocal_gender berlaku di kedua mode.
Endpoint ini menggunakan rute terpisah, sehingga beberapa nama bidang berbeda dari endpoint lain: style (bukan tags).

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).
custom
boolean
default:"false"
false=mode inspirasi; true=mode kustom (prompt sebagai lirik). Default false.
instrumental
boolean
default:"false"
true=musik instrumental murni, tanpa vokal. Default false.
version
string
wajib
Versi pembuatan: v3.5 / v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, memengaruhi kualitas audio dan penagihan. Wajib di kedua mode; jika tidak dikirim, langsung mengembalikan 400.
prompt
string
Prompt inspirasi / lirik. Wajib saat custom=false (digunakan sebagai deskripsi inspirasi). Saat custom=true: wajib jika instrumental=false (digunakan sebagai lirik); opsional jika instrumental=true. Jika tidak ada, 400 langsung dikembalikan saat pengiriman (tanpa memanggil upstream, tanpa penagihan).
title
string
Judul (mode kustom). Diabaikan saat custom=false (mode inspirasi).
style
string
Tag gaya (mode kustom, dipetakan ke tags upstream). Diabaikan saat custom=false (mode inspirasi).
negative_tags
string
Tag gaya negatif (gaya yang tidak Anda inginkan). Hanya berlaku saat custom=true.
auto_lyrics
boolean
true=menulis ulang lirik yang diberikan secara kreatif. Hanya berlaku saat custom=true.
persona_id
string
Id gaya Persona. Hanya berlaku saat custom=true.
vocal_gender
string
Jenis kelamin vokal: Male / Female (m / f / male / female juga diterima dan dinormalisasi otomatis oleh backend). Berlaku di kedua mode.
style_weight
number
Bobot gaya, 0.001.00. Hanya berlaku saat custom=true.
weirdness_constraint
number
Tingkat kreativitas, 0.001.00. Hanya berlaku saat custom=true.
audio_weight
number
Bobot audio, 0.001.00. Hanya berlaku saat custom=true.
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[] (juga tersedia image_url / video_url / title / duration, dll.). 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