> ## 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.

# Instrucciones para la integración de la API Suno Wav

> Suno Music Generation 集成指南 - XHuoAPI

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`.

```python theme={null}
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:

```json theme={null}
{
  "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.