Skip to main content
POST
Referensi audio sumber: tidak perlu ID tambahan untuk trek dari lagu yang ada. Kirim task_id tugas sumber dan audio_index untuk memilih dalam data.result.music[] (mulai dari 1; default 1).
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 tugas sumber. Nilai ini harus merujuk ke tugas unggahan uploadTask. Jika tidak ada, bukan tugas unggahan, atau sumber tidak dapat dikenali, permintaan akan mengembalikan 400 saat dikirim.
integer
default:"1"
Memilih trek dari data.result.music[] tugas sumber (mulai dari 1; 1 adalah trek pertama dan nilai default).
number
wajib
Titik awal sampling (detik). Jika tidak ada, langsung mengembalikan 400.
number
wajib
Waktu akhir sampel dalam detik. Harus memenuhi 0 ≤ start_s < end_s dan tidak melebihi durasi sumber yang diketahui.
boolean
default:"false"
Apakah murni instrumental (true=tanpa vokal); jika tidak dikirim, default false (dengan vokal).
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
Wajib bersyarat: sertakan lirik saat custom=true && instrumental=false. Kolom ini tidak digunakan dalam mode inspirasi, tetapi nilai yang dikirim tetap harus memenuhi batas panjang.
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.
boolean
true=menulis ulang lirik yang diberikan secara kreatif. Hanya berlaku saat custom=true.
number
Bobot gaya, 0.00–1.00 (nilai di luar rentang langsung mengembalikan 400 saat pengiriman). Hanya berlaku saat custom=true.
number
Bobot kreativitas, 0.00–1.00. weirdness_constraint adalah alias kompatibilitas; gunakan weirdness untuk permintaan baru.
number
Bobot audio, 0.00–1.00. Hanya berlaku saat custom=true.
string
Jenis vokal: Male / Female. Berlaku pada kedua mode.
string
Variasi gaya: off / normal / high / extra / max. Opsional.
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.
Tugas sumber harus berupa unggahan uploadTask. start_s dan end_s wajib; layanan tidak mengisi default seperti 0 atau 60.
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