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 dari tugas yang menghasilkan trek sumber. Jika tidak ada atau sumber tidak dapat diselesaikan, 400 dikembalikan 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.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
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, vocal_gender, 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