Skip to main content
POST
Mereferensikan trek sumber: Operasi berbasis lagu yang sudah ada tidak memerlukan pencatatan id tambahan apa pun, cukup kirim task_id (task_id dari tugas yang menghasilkan trek sumber) + audio_index (lagu ke berapa dalam music[] hasilnya, berbasis 1, default 1).
Endpoint ini tidak memiliki dimensi versi: jangan kirim version — jika dikirim, akan diabaikan dan tidak memengaruhi penagihan.

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"
Lagu ke berapa dalam data.music[] dari hasil tugas sumber yang direferensikan (berbasis 1; default 1; sekali pembuatan biasanya menghasilkan 2 lagu: indeks 1 dan 2).
string
wajib
Nama Persona; jika tidak ada, langsung mengembalikan 400.
string
Deskripsi.
string
Gaya.
string
id yang diperoleh dari «Ekstraksi Vox».
integer
Awal klip vokal (detik). Saat mereferensikan vox_audio_id, ini harus sesuai dengan rentang klip yang digunakan saat Vox tersebut diekstrak.
integer
Akhir klip vokal (detik). Saat mereferensikan vox_audio_id, ini harus sesuai dengan rentang klip yang digunakan saat Vox tersebut diekstrak.
Mengambil hasil: Endpoint ini adalah tugas asinkron. Setelah pengiriman, Anda mendapatkan task_id; lakukan polling GET /v1/music/tasks/{task_id} dengan interval 3–5 detik hingga status menjadi completed atau failed (biasanya memakan waktu 30–120 detik; selama pembuatan, status adalah pending dan progress berjalan queued 10 → ready 50 → done 100). Hasil berisi informasi persona. Jika gagal, data.error.message memberikan alasannya dan kuota yang dipotong di muka otomatis dikembalikan.

Response

integer
Kode status respons
array
Array data yang dikembalikan