Saltar al contenido 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 nos permite obtener archivos de música en formato wav. Este documento explica el método para integrar la API correspondiente. El parámetro principal de entrada de esta API es audio_id, que es el ID de la canción generado oficialmente; opcionalmente también soporta callback_url para una llamada asíncrona de retorno. Aquí el audio_id que usamos es 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)
El resultado es el siguiente: 
{
  "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"
    }
  ]
}
Se puede observar que el campo file_url dentro de data es el archivo de música en formato wav obtenido, el cual es una dirección CDN accesible públicamente.
Sobre la persistencia y vigencia del enlace WAV Los archivos WAV en el CDN de Suno upstream (https://cdn1.suno.ai/{audio_id}.wav) solo se mantienen por unos días, luego son eliminados y al acceder retornan un error 403. Para evitar que el enlace expire, esta API automáticamente copia el archivo WAV upstream a nuestro propio CDN (https://platform.cdn.xhuoapi.ai/suno/{task_id}.wav) antes de devolver la respuesta. El file_url retornado es la dirección estable del archivo copiado, que no expirará inmediatamente por la caducidad del CDN upstream. La vigencia del enlace copiado es de 30 días; después de ese periodo el archivo será limpiado periódicamente, por lo que se recomienda descargarlo y almacenarlo adecuadamente en su propio sistema cuanto antes. En casos muy raros en que la copia falle, se devolverá el URL original upstream, manteniendo el comportamiento histórico.