API pembuatan/pengambilan WAV

Diperbarui 2026-09-18 · tim Suno-API

Deskripsi endpoint

Endpoint WAV membuat atau mengambil alamat audio WAV tanpa kehilangan dari lagu yang sudah ada.

Endpoint: POST /api/music/wav

Biaya: Gratis. Endpoint ini membuat atau mengambil alamat WAV lagu yang sudah ada dan tidak memotong kuota.

Waktu tunggu dan timeout (penting): ini endpoint sinkron — pesanan baru diterima 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. 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

maxAttempts dan intervalSeconds keduanya angka JSON; intervalSeconds diukur dalam detik, bukan milidetik, dan biasanya cukup dengan nilai default. Keduanya hanya mengatur berapa kali dan seberapa sering endpoint ini menunggu WAV siap di dalam; tidak mengubah status tugas pembuatan itu sendiri.

Contoh permintaan

curl -X POST https://www.suno-api.io/api/music/wav \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "maxAttempts": 24,
    "intervalSeconds": 5
  }'

Respons

{
  "code": 200,
  "message": "success",
  "data": {
    "audioId": "clip_id",
    "status": "complete",
    "wavUrl": "https://media.code-go.com/assets/example.wav"
  }
}

Catatan

Pembuatan dan pencarian WAV dipilih otomatis oleh server dari catatan lagu; pelanggan tidak perlu memberikan informasi akun apa pun.

Lagu biasa dan track terpisah memakai jalur pengiriman media terkendali yang sama. WAV diunduh dan ditulis ke disk terlebih dahulu oleh CN2, dan data.wavUrl pada respons yang berhasil hanya mengembalikan alamat CDN terkendali — bukan alamat sumber sementara Suno atau S3.

Jika sudah ada aset WAV berstatus ready, aset itu dipakai ulang, tanpa meminta lagi ke Suno atau memindahkan berkas ulang. WAV yang belum disiapkan tidak diekspos sebagai alamat Suno/S3 melalui /api/music/query; baru disiapkan sesuai kebutuhan setelah memanggil endpoint ini atau endpoint unduhan terpadu.

⚠️ Masa berlaku alamat WAV: 7 hari — simpan tepat waktu. data.wavUrl yang dikembalikan disediakan oleh penyimpanan objek platform dan kedaluwarsa setelah 7 hari secara default (berkas ditarik kembali dan alamat lama mengembalikan 404). Simpan WAV ke penyimpanan Anda sendiri dalam masa berlaku itu; setelah kedaluwarsa, panggil lagi endpoint ini untuk mendapatkan alamat valid yang baru.

Jika sumber daya lagu sementara tidak tersedia, endpoint mengembalikan 409. Coba lagi nanti; server tidak mengembalikan alamat sementara yang tidak stabil.