API di generazione/recupero WAV

Aggiornato il 2026-09-18 · team Suno-API

Descrizione dell'endpoint

L'endpoint WAV genera o recupera l'indirizzo audio WAV senza perdita di un brano esistente.

Endpoint: POST /api/music/wav

Fatturazione: Gratuito. Questo endpoint genera o recupera l'indirizzo WAV di un brano esistente e non scala quota.

Tempi di attesa e timeout (importante): è un endpoint sincrono — l'ordine viene accettato solo quando arriva la risposta. Dai dati misurati, la maggior parte delle richieste risponde in 1-3 secondi, circa il 10% supera i 30 secondi e la più lunga arriva a circa 230 secondi. Imposta il timeout del client a 300 secondi o più; nessuna risposta non significa che non sia stato generato nulla, e non ritentare subito dopo un timeout. Se la connessione è caduta, verifica più tardi con GET /api/music/songs. Vedi «Tempi di attesa e impostazione del timeout» nella Panoramica della nuova API.

Parametri della richiesta

Headers

Parametri del corpo

maxAttempts e intervalSeconds sono entrambi numeri JSON; intervalSeconds si misura in secondi, non in millisecondi, e di solito basta mantenere i valori predefiniti. Controllano solo quante volte e con quale intervallo questo endpoint attende internamente che il WAV sia pronto; non modificano lo stato dell'attività di generazione in sé.

Esempio di richiesta

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

Risposta

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

Note

La generazione e la consultazione del WAV sono scelte automaticamente dal server in base al record del brano; il cliente non deve fornire alcuna informazione sull'account.

I brani normali e le tracce separate usano lo stesso percorso controllato di distribuzione dei media. Il WAV viene prima scaricato e salvato su disco da CN2, e il data.wavUrl di una risposta riuscita restituisce solo un indirizzo CDN controllato — mai un indirizzo sorgente temporaneo Suno o S3.

Se esiste già un asset WAV in stato ready viene riutilizzato, senza richiederlo di nuovo a Suno né spostare di nuovo i file. Un WAV non ancora preparato non viene esposto come indirizzo Suno/S3 tramite /api/music/query; viene preparato su richiesta solo dopo la chiamata a questo endpoint o all'endpoint di download unificato.

⚠️ Validità dell'indirizzo WAV: 7 giorni — salvalo per tempo. Il data.wavUrl restituito è fornito dall'object storage della piattaforma e scade per impostazione predefinita dopo 7 giorni (il file viene recuperato e il vecchio indirizzo restituisce 404). Salva il WAV nel tuo storage entro quel termine; dopo la scadenza richiama questo endpoint per ottenere un nuovo indirizzo valido.

Se la risorsa del brano non è temporaneamente disponibile, l'endpoint restituisce 409. Riprova più tardi; il server non restituisce indirizzi temporanei instabili.