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).
Pada extend, custom opsional dan default-nya true. Dengan custom=true, prompt berisi lirik lanjutan. Hanya custom=false eksplisit yang membuat gpt_description mengarahkan lanjutan.

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 langsung dikembalikan saat pengiriman.
integer
default:"1"
Memilih trek dari data.result.music[] tugas sumber (mulai dari 1; default 1).
number
wajib
Detik mulai lanjutan; minimal 1 dan lebih kecil dari durasi aktual trek sumber. Mendukung desimal.
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
default:"true"
true = lanjutkan dengan lirik prompt; false = lanjutan berbasis inspirasi. Default saat dihilangkan: true.
string
Lirik untuk perpanjangan. Berlaku saat custom=true.
string
Deskripsi inspirasi. Hanya berlaku jika custom=false dikirim secara eksplisit dan digunakan untuk mengarahkan lanjutan.
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.
string
Jenis kelamin vokal: Male / Female. Berlaku di kedua mode.
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. Nama lama weirdness_constraint didukung; gunakan weirdness untuk permintaan baru.
number
Bobot audio, 0.00–1.00. Hanya berlaku saat custom=true.
boolean
true=menulis ulang lirik yang diberikan secara kreatif. Hanya berlaku saat custom=true.
string
ID gaya Persona. Hanya berlaku dengan custom=true dan tidak dapat digunakan bersama custom_model_id.
integer
Durasi target 10–360 detik. Hanya saat custom=true; durasi aktual mengikuti hasil.
string
Variasi gaya: off / normal / high / extra / max. Opsional.
boolean
default:"false"
Apakah mode Max diaktifkan. Memerlukan custom=true dan dikenai biaya dua kali harga normal.
string
Format audio keluaran: mp3 / m4a / wav.
Hasil: tunggu tugas asinkron selesai lalu baca audio_url trek yang diperpanjang dari data.result.music[]. Jika gagal, dana yang dipotong dikembalikan.

Response

integer
Kode status respons
array
Array data yang dikembalikan