API de generare/obținere a WAV

Actualizat pe 2026-09-18 · echipa Suno-API

Descrierea endpoint-ului

Endpointul WAV generează sau obține adresa audio WAV fără pierderi a unei piese existente.

Endpoint: POST /api/music/wav

Facturare: Gratuit. Acest endpoint generează sau obține adresa WAV a unei piese existente și nu debitează din sold.

Timpii de așteptare și timeout-urile (important): este un endpoint sincron — comanda este acceptată doar când sosește răspunsul. Din măsurători, majoritatea cererilor răspund în 1-3 secunde, circa 10% depășesc 30 de secunde, iar cea mai lungă este de aproximativ 230 de secunde. Setează timeout-ul clientului la 300 de secunde sau mai mult; lipsa unui răspuns nu înseamnă că nu s-a generat nimic, iar reîncercarea imediat după un timeout nu este recomandată. Dacă conexiunea s-a întrerupt, verifică mai târziu cu GET /api/music/songs. Vezi „Timpii de așteptare și setarea timeout-ului” în Prezentarea noului API.

Parametrii cererii

Headers

Parametri din body

maxAttempts și intervalSeconds sunt ambele numere JSON; intervalSeconds se măsoară în secunde, nu în milisecunde, iar valorile implicite sunt de obicei suficiente. Ele controlează doar de câte ori și la ce interval așteaptă intern acest endpoint ca WAV-ul să fie gata; nu schimbă starea sarcinii de generare în sine.

Exemplu de cerere

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
  }'

Răspuns

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

Note

Generarea și căutarea WAV sunt alese automat de server pe baza înregistrării piesei; clientul nu trebuie să furnizeze date de cont.

Piesele normale și piesele separate folosesc aceeași cale controlată de livrare a conținutului media. WAV-ul este mai întâi descărcat și scris pe disc de CN2, iar data.wavUrl dintr-un răspuns reușit returnează doar o adresă CDN controlată — niciodată o adresă sursă temporară Suno sau S3.

Dacă există deja un activ WAV în starea ready, acesta este reutilizat, fără a cere din nou de la Suno și fără a muta din nou fișiere. Un WAV încă nepreparat nu este expus ca adresă Suno/S3 prin /api/music/query; este pregătit la cerere doar după apelarea acestui endpoint sau a endpointului unificat de descărcare.

⚠️ Valabilitatea adresei WAV: 7 zile — salvează-o la timp. data.wavUrl returnat este servit de stocarea obiectelor a platformei și expiră implicit după 7 zile (fișierul este recuperat, iar adresa veche returnează 404). Salvează WAV-ul în propriul tău spațiu de stocare în acest interval; după expirare, apelează din nou acest endpoint pentru o adresă validă nouă.

Dacă resursa piesei este temporar indisponibilă, endpointul returnează 409. Reîncearcă mai târziu; serverul nu returnează adrese temporare instabile.