API penambahan instrumen

Diperbarui 2026-09-18 · tim Suno-API

Deskripsi endpoint

Penambahan instrumen menata ulang lagu yang sudah ada, menambahkan instrumen, atau membuat struktur iringan baru.

Endpoint: POST /api/music/add-instrumental

Biaya: Berbayar, ditagih menurut model yang diminta; jumlah yang benar-benar ditagih mengikuti konfigurasi harga di back-office.

Max Mode / Variety: endpoint ini mendukung parameter opsional max_mode dan variety (0-4). Dengan max_mode aktif, panggilan ini ditagih 2× harga; variety tidak menambah biaya. Arti dan cara mengirimnya ada di bagian "Parameter lanjutan" pada Ringkasan API baru.

Model yang disarankan: suno-v6. Tersedia suno-v6, suno-v6-wild, dan suno-v6-mini.

Waktu tunggu dan timeout (penting): ini endpoint sinkron — pesanan baru diterima dan diteruskan ke pembuatan saat respons tiba. Dari pengukuran, sebagian besar permintaan merespons dalam 1-3 detik, sekitar 10% melewati 30 detik, dan terlama sekitar 230 detik. Setel timeout klien 300 detik atau lebih; tidak ada respons bukan berarti tidak ada yang dibuat, 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. Lihat "Waktu tunggu dan pengaturan timeout" di Ringkasan API baru.

Autentikasi

Parameter permintaan

Contoh permintaan

curl -X POST https://www.suno-api.io/api/music/add-instrumental \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "lyrics": "",
    "style_tags": "cinematic, strings, acoustic guitar",
    "song_title": "Versi instrumen yang diperkaya",
    "audio_weight": 1,
    "wait_completion": false
  }'

Respons

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "Versi instrumen yang diperkaya",
        "status": "pending"
      },
      {
        "song_id": "result_song_id_2",
        "song_title": "Versi instrumen yang diperkaya",
        "status": "pending"
      }
    ]
  }
}

Satu panggilan mengembalikan 2 hasil (ditagih sebagai 2 lagu); contoh menampilkan 2. Acuannya panjang array clips dan jangan menulis perulangan dengan jumlah tetap. Simpan clips[].song_id lalu poling API kueri lagu dan riwayat sampai completed. Setelah itu Anda bisa memutar atau mengunduh lewat audio_url; lihat API pembuatan dan pengambilan WAV serta endpoint unduhan lainnya.

Catatan

• source_clip_id harus ID lagu asli yang sudah selesai dan dapat diakses kunci API saat ini; ID pengganti pending: tidak boleh dipakai.
• Penambahan instrumen bukan cover; bila butuh cover gunakan API cover dari klip sumber.
• Bila ingin menambahkan instrumen atau track tertentu ke lagu yang sudah ada, gunakan API penambahan track.