Vai al contenuto principale

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 ci permette di ottenere file musicali in formato wav. Questo documento spiega il metodo di integrazione con l’API corrispondente. Il parametro di input principale di questa API è audio_id, che è l’ID della canzone generato ufficialmente; opzionalmente supporta anche callback_url per il callback asincrono. Qui il valore di audio_id che inseriamo è 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)
Il risultato è il seguente: 
{
  "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"
    }
  ]
}
Si può notare che il campo file_url dentro data è il file musicale in formato wav ottenuto, ed è un indirizzo CDN accessibile pubblicamente.
Riguardo alla persistenza e validità del link WAV Il file WAV sul CDN upstream di Suno (https://cdn1.suno.ai/{audio_id}.wav) viene mantenuto solo per pochi giorni, dopodiché viene rimosso e l’accesso restituisce 403. Per evitare che il link scada, questa API prima di restituire effettua automaticamente una copia del file WAV upstream sul nostro CDN (https://platform.cdn.xhuoapi.ai/suno/{task_id}.wav), e il file_url restituito è l’indirizzo stabile della copia, che non scadrà immediatamente a causa dell’expiry del CDN upstream. La validità del link copiato è di 30 giorni, dopo i quali il file sarà periodicamente rimosso; si consiglia di scaricarlo il prima possibile e conservarlo nel proprio storage. In caso di fallimento della copia (molto raro), si ritorna all’URL originale upstream, mantenendo il comportamento storico.