Langsung ke konten utama
POST
Mereferensikan trek sumber: Operasi berbasis lagu yang sudah ada tidak memerlukan pencatatan id hulu apa pun, cukup kirim task_id (task_id kami 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

Authorization
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

model
string
default:"suno"
Model audio. Saat ini kirim suno (jika tidak dikirim, default suno).
task_id
string
wajib
task_id kami dari tugas yang menghasilkan trek sumber. Jika tidak ada atau sumber tidak dapat diselesaikan, 400 dikembalikan saat pengiriman.
audio_index
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).
name
string
wajib
Nama Persona; jika tidak ada, langsung mengembalikan 400 tanpa memanggil hulu.
describe
string
Deskripsi.
styles
string
Gaya.
vox_audio_id
string
id yang diperoleh dari «Ekstraksi Vox».
vocal_start_s
integer
Awal klip vokal (detik). Saat mereferensikan vox_audio_id, ini harus sesuai dengan rentang klip yang digunakan saat Vox tersebut diekstrak.
vocal_end_s
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

code
integer
Kode status respons
data
array
Array data yang dikembalikan