API voor het genereren/ophalen van WAV

Bijgewerkt op 2026-09-18 · Suno-API-team

Beschrijving van het endpoint

Het WAV-endpoint genereert of haalt het verliesvrije WAV-audioadres van een bestaand nummer op.

Endpoint: POST /api/music/wav

Facturering: Gratis. Dit endpoint genereert of haalt het WAV-adres van een bestaand nummer op en schrijft geen tegoed af.

Wachttijden en timeouts (belangrijk): dit is een synchroon endpoint — de opdracht wordt pas geaccepteerd wanneer het antwoord binnenkomt. Gemeten: de meeste verzoeken antwoorden in 1-3 seconden, ongeveer 10% duurt langer dan 30 seconden en de langste is ongeveer 230 seconden. Zet de client-timeout op 300 seconden of meer; geen antwoord betekent niet dat er niets is gegenereerd, en probeer niet direct na een timeout opnieuw. Als de verbinding wegviel, controleer later met GET /api/music/songs. Zie "Wachttijden en timeout-instellingen" in het Overzicht van de nieuwe API.

Verzoekparameters

Headers

Body-parameters

maxAttempts en intervalSeconds zijn beide JSON-getallen; intervalSeconds wordt in seconden gemeten, niet in milliseconden, en de standaardwaarden zijn meestal voldoende. Ze bepalen alleen hoe vaak en met welk interval dit endpoint intern wacht tot de WAV klaar is; de status van de generatieopdracht zelf verandert er niet door.

Voorbeeldverzoek

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

Antwoord

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

Opmerkingen

Het genereren en opvragen van WAV kiest de server automatisch op basis van het nummerrecord; de klant hoeft geen accountgegevens aan te leveren.

Normale nummers en gescheiden tracks gebruiken hetzelfde gecontroleerde media-leveringspad. De WAV wordt eerst door CN2 gedownload en op schijf gezet, en de data.wavUrl in een geslaagd antwoord bevat alleen een gecontroleerd CDN-adres — nooit een tijdelijk bronadres van Suno of S3.

Bestaat er al een WAV-asset in de status ready, dan wordt die hergebruikt, zonder Suno opnieuw te vragen of bestanden opnieuw te verplaatsen. Een nog niet voorbereide WAV wordt niet via /api/music/query als Suno/S3-adres getoond; die wordt pas op verzoek voorbereid nadat dit endpoint of het uniforme download-endpoint is aangeroepen.

⚠️ Geldigheid van het WAV-adres: 7 dagen — sla het tijdig op. De teruggegeven data.wavUrl wordt geleverd door de objectopslag van het platform en verloopt standaard na 7 dagen (het bestand wordt teruggehaald en het oude adres geeft 404). Sla de WAV binnen die termijn op in uw eigen opslag; na het verlopen roept u dit endpoint opnieuw aan voor een nieuw geldig adres.

Als de nummerbron tijdelijk niet beschikbaar is, geeft het endpoint 409 terug. Probeer het later opnieuw; de server geeft geen onstabiele tijdelijke adressen terug.