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

# Instruções para Integração da API Suno Wav

> Suno Music Generation 集成指南 - XHuoAPI

A SUNO nos permite obter arquivos de música no formato wav. Este documento explica o método de integração da API relacionada.

O principal parâmetro de entrada desta API é `audio_id`, que é o ID da música gerado oficialmente; opcionalmente, também suporta o endereço de callback assíncrono `callback_url`.

Aqui, o `audio_id` que inserimos é `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)
```

O resultado é o seguinte:

```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"
    }
  ]
}
```

Pode-se observar que o campo `file_url` dentro de `data` é o arquivo de música no formato wav obtido, que é um endereço CDN acessível publicamente.

> **Sobre a persistência e validade do link WAV**
>
> Os arquivos WAV no CDN upstream da Suno (`https://cdn1.suno.ai/{audio_id}.wav`) são mantidos apenas por alguns dias e depois são removidos, retornando 403 ao acessar.
> Para evitar que o link expire, esta API automaticamente transfere o arquivo WAV upstream para nosso próprio CDN (`https://platform.cdn.xhuoapi.ai/suno/{task_id}.wav`) antes de retornar, e o `file_url` retornado é o endereço estável após a transferência, que não expirará imediatamente devido à expiração do CDN upstream.
> **O link transferido tem validade de 30 dias**; após 30 dias, o arquivo será limpo periodicamente. Recomenda-se baixar o arquivo o quanto antes e armazená-lo adequadamente em seu próprio armazenamento.
> Em casos raros de falha na transferência, o link original upstream será retornado, mantendo o comportamento histórico.