Skip to main content
POST
Mereferensikan trek sumber: mashup memerlukan tepat 2 trek sumber — tentukan via task_ids (array berisi tepat 2 task_id Anda), dengan audio_indexes opsional (array paralel yang menentukan item ke berapa dalam music[] tiap task, berbasis 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
Array task_id Anda untuk 2 trek sumber (harus tepat 2; jumlah lain langsung mengembalikan 400 saat pengiriman).
integer[]
Array sejajar dengan task_ids untuk memilih trek dari data.result.music[] setiap tugas (mulai dari 1; default tiap elemen 1).
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 dan persona_id.
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
ID gaya Persona. Hanya berlaku dengan custom=true dan tidak dapat digunakan bersama custom_model_id.
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.
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