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 field yang berlaku. Semua field yang dikirim tetap harus memenuhi tipe, rentang, dan panjang walau tidak berlaku dalam mode terpilih. Dengan custom=true, field lirik dan gaya berlaku sedangkan gpt_description diabaikan. Dengan custom=false, hanya gpt_description yang berlaku dan wajib; jika hilang, responsnya 400. vocal_gender berlaku pada kedua mode. Jika custom dihilangkan, server menyimpulkannya dari prompt, lalu gpt_description, lalu tags atau 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 target. 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. Nama lama weirdness_constraint didukung; gunakan weirdness untuk permintaan baru.
number
Bobot audio, 0.001.00. Hanya berlaku saat custom=true.
string
Jenis kelamin vokal: Male / Female. Berlaku 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