WAV-Erzeugungs-/Abruf-API

Aktualisiert am 2026-09-18 · Suno-API-Team

Beschreibung des Endpunkts

Der WAV-Endpunkt erzeugt oder ruft die verlustfreie WAV-Audioadresse eines bestehenden Songs ab.

Endpunkt: POST /api/music/wav

Abrechnung: Kostenlos. Dieser Endpunkt erzeugt oder ruft die WAV-Adresse eines bestehenden Songs ab und zieht kein Guthaben ab.

Wartezeiten und Timeouts (wichtig): Dies ist ein synchroner Endpunkt — die Bestellung wird erst angenommen, wenn die Antwort eintrifft. Gemessen antworten die meisten Anfragen in 1-3 Sekunden, etwa 10 % brauchen länger als 30 Sekunden und die längste liegt bei rund 230 Sekunden. Setzen Sie den Client-Timeout auf 300 Sekunden oder mehr; keine Antwort bedeutet nicht, dass nichts generiert wurde, und wiederholen Sie nicht direkt nach einem Timeout. Wenn die Verbindung abbrach, prüfen Sie später mit GET /api/music/songs. Siehe „Wartezeiten und Timeout-Einstellungen“ in der Übersicht der neuen API.

Anfrageparameter

Headers

Body-Parameter

maxAttempts und intervalSeconds sind beide JSON-Zahlen; intervalSeconds wird in Sekunden gemessen, nicht in Millisekunden, und die Standardwerte reichen in der Regel aus. Sie steuern nur, wie oft und in welchem Abstand dieser Endpunkt intern auf die Bereitschaft des WAV wartet; den Zustand des Generierungsauftrags selbst ändern sie nicht.

Beispielanfrage

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

Antwort

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

Hinweise

Die WAV-Erzeugung und -Abfrage wählt der Server automatisch anhand des Song-Datensatzes aus; der Kunde muss keine Kontoinformationen angeben.

Normale Songs und getrennte Spuren nutzen denselben kontrollierten Medien-Auslieferungsweg. Das WAV wird zuerst von CN2 heruntergeladen und auf die Festplatte geschrieben, und data.wavUrl in einer erfolgreichen Antwort gibt nur eine kontrollierte CDN-Adresse zurück — niemals eine temporäre Suno- oder S3-Quelladresse.

Existiert bereits ein ready-WAV-Asset, wird es wiederverwendet, ohne Suno erneut anzufragen oder Dateien erneut zu verschieben. Ein noch nicht vorbereitetes WAV wird nicht über /api/music/query als Suno/S3-Adresse offengelegt; es wird erst nach dem Aufruf dieses Endpunkts oder des einheitlichen Download-Endpunkts bei Bedarf vorbereitet.

⚠️ Gültigkeit der WAV-Adresse: 7 Tage — rechtzeitig sichern. Die zurückgegebene data.wavUrl wird vom Objektspeicher der Plattform bereitgestellt und läuft standardmäßig nach 7 Tagen ab (die Datei wird zurückgeholt und die alte Adresse liefert 404). Sichern Sie das WAV innerhalb der Gültigkeit in Ihren eigenen Speicher; nach Ablauf rufen Sie diesen Endpunkt erneut auf, um eine neue gültige Adresse zu erhalten.

Ist die Song-Ressource vorübergehend nicht verfügbar, liefert der Endpunkt 409. Versuchen Sie es später erneut; der Server liefert keine instabilen temporären Adressen.