API Extend (perpanjangan)

Diperbarui 2026-09-18 · tim Suno-API

Deskripsi endpoint

Extend melanjutkan lagu yang sudah ada dari titik waktu yang dipilih dan membuat bagian berikutnya.

Endpoint: POST /api/music/extend

Biaya: Berbayar, saat ini default 0,6 ¥ per panggilan. Jumlah yang benar-benar ditagih mengikuti konfigurasi harga di back-office saat ini.

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

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.

Parameter permintaan

Headers

Parameter body

Contoh permintaan

curl -X POST https://www.suno-api.io/api/music/extend \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "prompt": "lanjutkan reff dengan emosi lebih kuat",
    "continueAt": 60,
    "style": "Mandopop, rock",
    "negativeTags": "noise",
    "title": "Versi diperpanjang",
    "waitAudio": false
  }'

Respons

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "extended_clip_id",
        "song_title": "Versi diperpanjang",
        "status": "pending"
      }
    ]
  }
}

Kolom yang kompatibel

Nama kolom lama masih diterima:

Catatan

• Jangan mulai menempel di akhir: panjang perpanjangan pada dasarnya adalah "sisa setelah titik awal". Jika titik awal terlalu dekat dengan akhir, hasilnya hanya beberapa detik — dari pengukuran, lagu 242 detik yang diperpanjang dari detik 240 hanya menghasilkan 2,7 detik (dan tetap ditagih per panggilan). Sisakan minimal 10 detik setelah titik awal.
• Extend tidak punya ambang "sumber terlalu pendek": dari pengukuran, klip 9,6 detik yang diperpanjang dari detik 5 tetap menghasilkan lagu normal, jadi sumber pendek atau sisa pendek bukan alasan penolakan.
• Titik awal harus lebih besar dari 0: continueAt=0 diterima platform lalu dibatalkan, tanpa mengembalikan alasan kegagalan, jadi mulailah tepat setelah detik pertama.
• Satu panggilan mengembalikan 2 hasil (ditagih sebagai 2 lagu); acuannya panjang array clips.
• Hasilnya adalah karya baru; lagu asli tidak terpengaruh.