API unggah audio sumber

Diperbarui 2026-09-18 · tim Suno-API

Deskripsi endpoint

Unggah audio sumber mengubah berkas audio lokal atau jarak jauh menjadi clip sumber yang bisa dipakai kemampuan berikutnya: cover, perpanjangan, penggantian bagian, pemisahan, dan lainnya.

Endpoint: POST /api/music/upload-source

Biaya: Gratis. Endpoint ini hanya mengunggah audio sumber; tidak memulai tugas pembuatan.

Penggunaan yang disarankan: ini langkah 1 dari «cover dua langkah». Unggah audio lebih dulu dengan endpoint ini (gratis, dan bisa dicoba ulang kapan pun gagal) lalu simpan clip_id yang dikembalikan; setelah memastikan unggahan berhasil (status dalam keadaan selesai), panggil API cover dari clip sumber untuk memulai cover — body permintaan itu hanya beberapa ratus byte, sehingga tidak bisa terpotong saat transit karena audio terlalu besar. Dibandingkan API sekali jalan unggah lalu cover, pemisahan ini lebih andal ketika audio besar, jaringan tidak stabil, atau materi yang sama akan dipakai ulang beberapa kali (perpanjangan / penggantian / pemisahan).

Saran untuk unggahan berkas besar

Setelah unggahan selesai, selalu pastikan status pada respons sudah berstatus selesai dan simpan clip_id sebelum lanjut ke langkah 2; unggahan yang gagal tidak ditagih dan tidak membuat tugas pembuatan — cukup coba lagi.

Parameter permintaan

Headers

Untuk permintaan JSON:

Jangan set Content-Type secara manual pada permintaan multipart; klien membuatnya otomatis.

Parameter body

Contoh permintaan JSON

curl -X POST https://www.suno-api.io/api/music/upload-source \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "file_url": "https://example.com/source.mp3",
    "file_name": "source.mp3",
    "upload_type": "file_upload"
  }'

Contoh permintaan multipart

curl -X POST https://www.suno-api.io/api/music/upload-source \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@source.mp3" \
  -F "file_name=source.mp3" \
  -F "upload_type=file_upload" \
  -F "model=suno-v6"

Respons

{
  "clip_id": "uploaded_clip_id",
  "status": "complete",
  "title": "source.mp3",
  "image_url": "https://...",
  "audio_url": "https://...",
  "display_tags": "pop, vocal",
  "inferred_description": "uploaded source audio",
  "clip_metadata": {}
}