API Crop (pemotongan)

Diperbarui 2026-09-18 · tim Suno-API

Deskripsi endpoint

Crop mempertahankan satu rentang waktu lagu yang sudah ada dan membuat versi terpotong baru.

Endpoint: POST /api/music/crop

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

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/crop \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "crop_start_s": 10,
    "crop_end_s": 48,
    "song_title": "Versi terpotong"
  }'

Respons

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "Versi terpotong",
        "status": "processing"
      }
    ]
  }
}

Satu panggilan mengembalikan 1 hasil (aksi pengeditan tidak menghasilkan 2 lagu). Simpan clips[].song_id lalu polling API kueri lagu sampai completed. Kadang respons pertama belum mendaftarkan song_id yang bisa dikueri; tunggu sebentar lalu kueri lagi.

Catatan

• Rentang yang dipertahankan harus memenuhi 0 <= crop_start_s < crop_end_s dan berada dalam durasi lagu sumber.
• Berbeda dari pemotongan, untuk menghapus bagian gunakan API hapus bagian.