API remaster (Remaster)

Diperbarui 2026-09-18 · tim Suno-API

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

BerikutnyaAPI Replace Section (ganti bagian)

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