> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/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 API guide - Ace Data Cloud

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.acedata.cloud/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.acedata.cloud/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.acedata.cloud/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.