API hapus bagian
Deskripsi endpoint
Hapus bagian menghapus satu rentang waktu dari lagu yang sudah ada dan menyambung bagian sisanya menjadi versi baru.
Endpoint: POST /api/music/remove-section
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 | Tipe | Wajib | Catatan |
|---|---|---|---|
| Authorization | string | ya | Bearer YOUR_API_KEY |
| Content-Type | string | ya | application/json |
Parameter permintaan
| Parameter | Tipe | Wajib | Default | Catatan |
|---|---|---|---|---|
| model | string | ya | - | Nama model untuk pelanggan: suno-v6, suno-v6-wild, atau suno-v6-mini |
| source_clip_id | string | ya | - | song_id asli lagu sumber; harus sudah selesai dan dapat diakses kunci API saat ini |
| crop_start_s | number | ya | - | Detik awal rentang yang dihapus; harus 0 atau lebih |
| crop_end_s | number | ya | - | Detik akhir rentang yang dihapus; harus lebih besar dari crop_start_s |
| song_title | string | tidak | - | Judul hasil |
Contoh permintaan
curl -X POST https://www.suno-api.io/api/music/remove-section \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"source_clip_id": "source_song_id",
"crop_start_s": 30,
"crop_end_s": 45,
"song_title": "Versi tanpa satu bagian"
}'
Respons
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "result_song_id",
"song_title": "Versi tanpa satu bagian",
"status": "processing"
}
]
}
}
Satu panggilan mengembalikan 1 hasil (aksi pengeditan tidak menghasilkan 2 lagu). Simpan clips[].song_id lalu polling API kueri lagu sampai completed.
Catatan
- Rentang yang dihapus harus memenuhi
0 <= crop_start_s < crop_end_sdan berada dalam durasi lagu sumber. - Untuk mempertahankan rentang alih-alih menghapusnya, gunakan API Crop.
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