Zum Hauptinhalt springen

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 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. 
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: 
{
  "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.