API remaster (Remaster)
Deskripsi endpoint
Remaster membuat ulang lagu yang sudah selesai menjadi "versi remaster" dengan kualitas audio lebih baik. Ia mengembalikan 2 versi sekaligus, dan pihak upstream otomatis menambahkan (Remastered) pada judul.
Endpoint: POST /api/music/remaster
Biaya: Berbayar, ditagih menurut model yang diminta (default suno-v6, 0,6 CNY per panggilan); jumlah yang benar-benar ditagih mengikuti konfigurasi harga di back-office.
Tentang model: remaster memakai endpoint upstream khusus dan model remaster khusus, ditetapkan platform dan tidak berubah mengikuti model; model pada permintaan hanya dipakai untuk harga dan pemilihan kanal, jadi sebaiknya kirim suno-v6 secara eksplisit.
Waktu tunggu dan timeout (penting): ini endpoint sinkron — pesanan baru diterima dan diteruskan ke remaster saat respons tiba. Setel timeout klien 300 detik atau lebih; tidak ada respons bukan berarti tidak ada yang diremaster, dan jangan mencoba ulang langsung setelah timeout (itu menduplikasi pesanan dan menagih dua kali). Jika koneksi terputus, periksa lagi nanti dengan
GET /api/music/songs.
Autentikasi
| Parameter | Tipe | Wajib | Catatan |
|---|---|---|---|
| Authorization | string | ya | Bearer YOUR_API_KEY |
| Content-Type | string | ya | application/json |
Parameter permintaan
| Parameter | Tipe | Wajib | Default | Catatan |
|---|---|---|---|---|
| song_id | string | ya | - | ID lagu sumber yang akan diremaster; harus sudah selesai dan dapat diakses kunci API saat ini |
| model | string | tidak | suno-v6 | Nama model untuk pelanggan: suno-v6, suno-v6-wild, atau suno-v6-mini; hanya untuk harga dan kanal |
| variation_category | string | tidak | normal | Kekuatan variasi: subtle, normal, high (nilai lama low setara subtle) |
| style_profile | string | tidak | boost | Gaya timbre: natural, boost, clarity |
| tags | string | tidak | - | Bidang cadangan; bila tidak kosong diteruskan ke upstream |
| source_audio_url | string | tidak | - | Alamat audio sumber, bila lagu sumber berasal dari akun eksternal |
| source_file_name | string | tidak | - | Nama berkas sumber, bila lagu sumber berasal dari akun eksternal |
| source_title | string | tidak | - | Judul sumber, bila lagu sumber berasal dari akun eksternal |
audio_id, source_clip_id, dan sourceClipId adalah penulisan yang setara dengan song_id; gunakan salah satu.
Contoh permintaan
curl -X POST https://www.suno-api.io/api/music/remaster \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"song_id": "source_song_id",
"variation_category": "high",
"style_profile": "clarity"
}'
Jika cukup dengan nilai default, kirim hanya lagu sumber — setara dengan variation_category: normal + style_profile: boost:
{ "model": "suno-v6", "song_id": "source_song_id" }
Respons
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "remastered_clip_id_1",
"song_title": "Judul lagu sumber (Remastered)",
"status": "processing"
},
{
"song_id": "remastered_clip_id_2",
"song_title": "Judul lagu sumber (Remastered)",
"status": "processing"
}
]
}
}
Satu panggilan mengembalikan 2 versi remaster. Simpan kedua clips[].song_id lalu poling API kueri lagu dan riwayat sampai complete sebelum mengambil audio.
Catatan
- Lagu sumber harus sudah selesai dan berada dalam cakupan akses kunci API saat ini; materi sumber eksternal disinkronkan otomatis ke akun yang menjalankan.
- Remaster hanya mengulang kualitas audio: untuk mengubah gaya, aransemen, atau vokal, gunakan penguatan gaya, unggah lalu cover, atau endpoint Remix.
- Semakin besar
variation_category, semakin berbeda versi remaster dari lagu sumber; sebelum pengiriman nyata, cobanormaldulu lalu naikkan.
Dapatkan kunci API
Buat kunci API di konsol setelah mendaftar. Setiap pembuatan berbiaya 0,6 ¥ dan menghasilkan 2 lagu, unduhan tidak terbatas, dan nomor telepon tidak diperlukan.
Ambil kunci API Kembali ke ringkasan