API penjanaan/pengambilan WAV

Dikemas kini 2026-09-18 · pasukan Suno-API

Penerangan endpoint

Endpoint WAV menjana atau mengambil alamat audio WAV tanpa kehilangan bagi lagu sedia ada.

Endpoint: POST /api/music/wav

Pengebilan: Percuma. Endpoint ini menjana atau mengambil alamat WAV lagu sedia ada dan tidak memotong kuota.

Masa menunggu dan timeout (penting): ini endpoint segerak — pesanan hanya diterima apabila respons tiba. Berdasarkan ukuran, kebanyakan permintaan membalas dalam 1-3 saat, kira-kira 10% melebihi 30 saat dan paling lama sekitar 230 saat. Tetapkan timeout klien kepada 300 saat atau lebih; tiada respons tidak bermakna tiada apa-apa dijana, dan jangan cuba semula sejurus selepas timeout. Jika sambungan terputus, periksa kemudian dengan GET /api/music/songs. Lihat "Masa menunggu dan tetapan timeout" dalam Gambaran keseluruhan API baharu.

Parameter permintaan

Headers

Parameter body

maxAttempts dan intervalSeconds kedua-duanya nombor JSON; intervalSeconds diukur dalam saat, bukan milisaat, dan biasanya nilai lalai sudah memadai. Kedua-duanya hanya mengawal berapa kali dan pada selang berapa endpoint ini menunggu WAV sedia di dalam; ia tidak mengubah status tugasan penjanaan 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"
  }
}

Nota

Penjanaan dan pencarian WAV dipilih secara automatik oleh pelayan daripada rekod lagu; pelanggan tidak perlu memberikan sebarang maklumat akaun.

Lagu biasa dan trek yang dipisahkan menggunakan laluan penyampaian media terkawal yang sama. WAV dimuat turun dan ditulis ke cakera terlebih dahulu oleh CN2, dan data.wavUrl dalam respons yang berjaya hanya memulangkan alamat CDN terkawal — bukan alamat sumber sementara Suno atau S3.

Jika sudah ada aset WAV berstatus ready, ia digunakan semula, tanpa meminta semula kepada Suno atau memindahkan fail lagi. WAV yang belum disediakan tidak didedahkan sebagai alamat Suno/S3 melalui /api/music/query; ia hanya disediakan atas permintaan selepas memanggil endpoint ini atau endpoint muat turun bersatu.

⚠️ Tempoh sah alamat WAV: 7 hari — simpan segera. data.wavUrl yang dipulangkan disediakan oleh storan objek platform dan tamat secara lalai selepas 7 hari (fail diambil semula dan alamat lama memulangkan 404). Simpan WAV ke storan anda sendiri dalam tempoh itu; selepas tamat, panggil semula endpoint ini untuk mendapatkan alamat sah yang baharu.

Jika sumber lagu tidak tersedia sementara, endpoint memulangkan 409. Cuba lagi kemudian; pelayan tidak memulangkan alamat sementara yang tidak stabil.