> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Suno Wav API Integrationsanleitung

> Suno Music Generation 集成指南 - XHuoAPI

SUNO ermöglicht es uns, Musikdateien im WAV-Format zu erhalten. Dieses Dokument erläutert die Integration der zugehörigen API.

Der zentrale Eingabeparameter dieser API ist `audio_id`, die offizielle, vom System generierte Song-ID; optional wird auch `callback_url` für asynchrone Rückrufe unterstützt.

Hier verwenden wir als `audio_id` den Wert `4e43116a-bf09-472c-8e1c-655eabf02682`.

```python theme={null}
import requests

url = "https://api.xhuoapi.ai/v1/suno/wav"

headers = {
    "accept": "application/json",
    "authorization": "Bearer aa287fa4cc54401087a9fab3f99630af",
    "content-type": "application/json"
}

payload = {
    "audio_id": "4e43116a-bf09-472c-8e1c-655eabf02682"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)
```

Das Ergebnis sieht wie folgt aus:

```json theme={null}
{
  "success": true,
  "task_id": "6a5a2099-d6d3-4930-9709-a30ac5dc7de5",
  "trace_id": "3fa70e81-6bb7-4ca8-b718-dd16a4eda7e8",
  "data": [
    {
      "file_url": "https://platform.cdn.xhuoapi.ai/suno/6a5a2099-d6d3-4930-9709-a30ac5dc7de5.wav"
    }
  ]
}
```

Man sieht, dass das Feld `file_url` im `data`-Array die URL zur Musikdatei im WAV-Format enthält. Diese ist eine öffentlich zugängliche CDN-Adresse.

> **Zur Persistenz und Gültigkeitsdauer des WAV-Links**
>
> Die WAV-Dateien auf dem upstream Suno CDN (`https://cdn1.suno.ai/{audio_id}.wav`) werden nur für wenige Tage gespeichert und anschließend gelöscht, wodurch ein Zugriff mit 403 beantwortet wird.
> Um Link-Verfall zu vermeiden, speichert diese API die upstream WAV-Datei vor der Rückgabe automatisch auf unserem eigenen CDN (`https://platform.cdn.xhuoapi.ai/suno/{task_id}.wav`). Die zurückgegebene `file_url` ist somit die stabile, zwischengespeicherte Adresse und verfällt nicht unmittelbar mit dem upstream CDN.
> **Die zwischengespeicherte Datei ist 30 Tage gültig.** Nach Ablauf dieser Frist wird die Datei regelmäßig gelöscht. Es wird empfohlen, die Datei zeitnah herunterzuladen und sicher in eigenem Speicher zu archivieren.
> Im seltenen Fall eines Speichervorgangsfehlers wird auf die originale upstream URL zurückgegriffen, womit das Verhalten historisch konsistent bleibt.