Skip to main content
POST
Trek sumber: sumber harus berasal dari tugas unggahan yang dibuat dengan POST /v1/music/generations/uploadTask. Kirim task_id-nya dan pilih trek dalam data.result.music[] dengan audio_index (mulai dari 1; default 1). Tugas pembuatan biasa tidak dapat digunakan.
custom menentukan kolom yang digunakan. Semua nilai yang dikirim tetap harus memenuhi persyaratan tipe, rentang, dan panjang, meskipun kolom tersebut tidak digunakan dalam mode yang dipilih. Saat custom=true, prompt berisi lirik dan dapat diwajibkan ketika instrumental=false sesuai ketentuan di bawah. Saat custom=false, gpt_description wajib diisi. Jika custom tidak dikirim, backend menentukan mode dari prompt, gpt_description, tags, dan title.

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
wajib
task_id yang dikembalikan oleh POST /v1/music/generations/uploadTask. Tugas generasi biasa tidak dapat digunakan. Sumber yang hilang atau tidak valid mengembalikan 400 saat pengiriman.
integer
default:"1"
Memilih trek dari data.result.music[] tugas sumber (mulai dari 1; default 1).
string
default:"v6"
Versi publik: v6 / v6-wild / v6-mini. Default v6; hilangkan saat memakai custom_model_id.
string
UUID lengkap yang dikembalikan tugas pembuatan model. Tidak dapat digunakan bersama version.
boolean
true=mode kustom (prompt digunakan sebagai lirik); false=mode inspirasi (menggunakan gpt_description); jika tidak dikirim, disimpulkan dari konten (lihat peringatan di atas).
string
Lirik. Berlaku saat custom=true (diabaikan dalam mode inspirasi).
string
Prompt inspirasi. Wajib saat custom=false — jika tidak ada, permintaan gagal dengan 400 saat pengiriman (tidak ada biaya yang dikenakan).
string
Judul. Hanya berlaku saat custom=true.
string
Tag gaya. Hanya berlaku saat custom=true.
string
Tag gaya yang dikecualikan. Hanya berlaku saat custom=true.
number
Bobot gaya, 0.001.00 (nilai di luar rentang langsung mengembalikan 400 saat pengiriman). Hanya berlaku saat custom=true.
number
Bobot kreativitas, 0.001.00. weirdness_constraint adalah alias kompatibilitas; gunakan weirdness untuk permintaan baru.
number
Bobot audio, 0.001.00. Hanya berlaku saat custom=true.
string
Jenis vokal: Male / Female. Bekerja di kedua mode.
string
Variasi gaya: off / normal / high / extra / max.
boolean
default:"false"
Mengaktifkan mode Max. Memerlukan mode kustom dan dikenai biaya dua kali harga standar.
string
Format audio keluaran: mp3 / m4a / wav. Endpoint ini tidak mendukung durasi target.
API ini tidak mendukung auto_lyrics, persona_id, instrumental, atau durasi target.
Ambil hasil: polling tugas hingga selesai. Pembuatan biasanya memerlukan 30–120 detik. Baca audio_url dari data.result.music[]; jika gagal, dana yang dipotong dikembalikan.

Response

integer
Kode status respons
array
Array data yang dikembalikan