Hoppa till huvudinnehåll

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 tillåter oss att få tillgång till musikens wav-formatfil, denna dokumentation förklarar hur man integrerar med API:et. Det centrala ingångsparametern för detta API är audio_id, vilket är den officiella genererade låt-ID:n; det stöds även att ange callback_url för asynkron callback. Här använder vi audio_id som 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)
Resultatet är som följer: 
{
  "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"
    }
  ]
}
Som ses är file_url-fältet i data den nedladdningsbara wav-formatfilen för musiken, vilket är en offentlig CDN-adress.
Om WAV-länkens beständighet och giltighetstid WAV-filer på upstream Suno CDN (https://cdn1.suno.ai/{audio_id}.wav) sparas endast i några dagar, varefter de tas bort och resulterar i 403 vid åtkomst. För att undvika att länken blir inaktuell, kopieras filen automatiskt till vår egen CDN (https://platform.cdn.xhuoapi.ai/suno/{task_id}.wav) innan den returns, och file_url är den stabila adressen efter kopiering, vilket inte immediate förlorar åtkomst pga expiration. Den kopierade länken är giltig i 30 dagar, efter denna period tas filen bort regelbundet, så det rekommenderas att ladda ner och spara den i egen lagring så snart som möjligt. Vid sällsynta fall av misslyckad kopiering (extremt sällsynt) återgår systemet till den ursprungliga upstream URL, med beteende som tidigare.