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).

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
Mengganti lirik segmen tersebut.
number
wajib
Titik awal penggantian (detik). Jika tidak ada, langsung mengembalikan 400.
number
wajib
Waktu akhir dalam detik. Harus memenuhi 0 ≤ start_s < end_s dan tidak melebihi durasi yang diketahui.
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.
string
Lirik konteks.
string
Judul.
string
Tag gaya.
string
Tag gaya yang dikecualikan.
string
Variasi gaya: off / normal / high / extra / max. Opsional.
boolean
default:"false"
Mengaktifkan mode Max dan dikenai biaya dua kali harga standar.
string
Format audio keluaran: mp3 / m4a / wav. Endpoint ini tidak mendukung durasi target.
prompt adalah konteks lirik asli dan infill_lyrics adalah lirik pengganti. Jangan kirim custom, instrumental, auto_lyrics, atau field sesi edit lama.
Ambil hasil: tunggu tugas selesai lalu baca audio_url trek pengganti dari data.result.music[]. Jika gagal, dana yang dipotong dikembalikan.

Response

integer
Kode status respons
array
Array data yang dikembalikan