API för att skapa/hämta WAV

Uppdaterad 2026-09-18 · Suno-API-teamet

Beskrivning av ändpunkten

WAV-ändpunkten skapar eller hämtar den förlustfria WAV-ljudadressen för en befintlig låt.

Ändpunkt: POST /api/music/wav

Fakturering: Kostnadsfritt. Den här ändpunkten skapar eller hämtar WAV-adressen för en befintlig låt och drar inget saldo.

Väntetider och timeouts (viktigt): detta är en synkron ändpunkt — beställningen accepteras först när svaret kommer. Mätt: de flesta anrop svarar på 1-3 sekunder, omkring 10% tar längre än 30 sekunder och det längsta är cirka 230 sekunder. Ställ in klientens timeout på 300 sekunder eller mer; inget svar betyder inte att inget genererades, och försök inte igen direkt efter en timeout. Om anslutningen bröts, kontrollera senare med GET /api/music/songs. Se "Väntetider och timeout-inställningar" i Översikt över det nya API:t.

Begäransparametrar

Headers

Body-parametrar

maxAttempts och intervalSeconds är båda JSON-tal; intervalSeconds mäts i sekunder, inte millisekunder, och standardvärdena räcker oftast. De styr bara hur många gånger och med vilket intervall ändpunkten internt väntar på att WAV blir redo; de ändrar inte själva genereringsuppdragets status.

Exempelbegäran

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

Svar

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

Noter

Skapande och uppslagning av WAV väljs automatiskt av servern utifrån låtposten; kunden behöver inte ange några kontouppgifter.

Vanliga låtar och separerade spår använder samma kontrollerade leveransväg för media. WAV laddas först ner och skrivs till disk av CN2, och data.wavUrl i ett lyckat svar innehåller bara en kontrollerad CDN-adress — aldrig en tillfällig källadress från Suno eller S3.

Finns redan en WAV-tillgång i status ready återanvänds den, utan att Suno tillfrågas igen eller filer flyttas på nytt. En WAV som ännu inte förberetts exponeras inte som Suno/S3-adress via /api/music/query; den förbereds först på begäran efter anrop till den här ändpunkten eller den enhetliga nedladdningsändpunkten.

⚠️ WAV-adressens giltighet: 7 dagar — spara i tid. Den returnerade data.wavUrl tillhandahålls av plattformens objektlagring och upphör som standard efter 7 dagar (filen återkallas och den gamla adressen ger 404). Spara WAV i din egen lagring inom giltighetstiden; efter att den gått ut anropar du den här ändpunkten igen för en ny giltig adress.

Om låtresursen tillfälligt inte är tillgänglig returnerar ändpunkten 409. Försök igen senare; servern returnerar inte instabila tillfälliga adresser.