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

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
Mengganti lirik segmen tersebut.
integer
wajib
Titik awal penggantian (detik). Jika tidak ada, langsung mengembalikan 400.
integer
wajib
Titik akhir penggantian (detik). Jika tidak ada, langsung mengembalikan 400.
string
default:"v5.5"
Versi pembuatan: v4 / v4.5+ / v5 / v5.5; jika tidak dikirim, default v5.5. Nilai lain apa pun (termasuk v3.5 / v4.5 / v4.5-all) langsung mengembalikan 400 saat pengiriman.
string
Lirik konteks.
string
Judul.
string
Tag gaya.
string
Tag gaya yang dikecualikan.
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 (pembuatan musik biasanya memakan waktu 30–120 detik; selama pembuatan, status adalah pending dan progress berjalan queued 10 → ready 50 → done 100). Setelah selesai, ambil audio_url yang sudah diganti dari data.result.music[]. 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