Passer au contenu principal

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 nous permet d’obtenir des fichiers musicaux au format wav. Ce document explique la méthode d’intégration de l’API correspondante. Le paramètre d’entrée principal de cette API est audio_id, qui est l’ID officiel généré pour la chanson ; il est également possible d’utiliser en option callback_url pour une callback asynchrone. Ici, nous utilisons comme audio_id la valeur 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)
Le résultat est le suivant : 
{
  "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"
    }
  ]
}
On peut voir que le champ file_url dans data est le fichier musical au format wav obtenu, il s’agit d’une adresse CDN accessible publiquement.
À propos de la persistance et de la durée de validité du lien WAV Les fichiers WAV sur le CDN Suno en amont (https://cdn1.suno.ai/{audio_id}.wav) ne sont conservés que quelques jours, puis sont supprimés, ce qui entraîne un code 403 lors de l’accès. Pour éviter l’expiration du lien, cette API transfère automatiquement le fichier WAV en amont vers notre propre CDN (https://platform.cdn.xhuoapi.ai/suno/{task_id}.wav) avant de le retourner ; l’URL file_url retournée est donc une adresse stable du fichier transféré, qui ne devient pas immédiatement invalide après l’expiration du CDN en amont. La durée de validité du lien transféré est de 30 jours ; passé ce délai, le fichier est nettoyé périodiquement. Il est recommandé de télécharger rapidement le fichier et de le sauvegarder correctement dans votre propre stockage. En cas d’échec du transfert (très rare), l’URL originale en amont sera renvoyée, ce qui maintient le comportement historique.