> ## 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 Wav API 對接說明

> Suno Music Generation 集成指南 - XHuoAPI

SUNO 允許我們獲取音樂的 wav 格式檔案，本文檔講解相關 API 的對接方法。

該 API 核心輸入參數是 `audio_id`，它是官方生成的歌曲 ID；可選還支援 `callback_url` 非同步回調地址。

這裡我們輸入的 `audio_id` 是 `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)
```

結果如下：

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

可以看到，`data` 的 `file_url` 欄位是獲取的音樂的 wav 格式檔案，它是一個可以公開訪問的 CDN 地址。

> **關於 WAV 連結的持久化與有效期**
>
> 上游 Suno CDN 上的 WAV 檔案（`https://cdn1.suno.ai/{audio_id}.wav`）只會保留幾天，之後會被回收，訪問時返回 403。
> 為避免連結失效，本接口在返回前會自動把上游 WAV 檔案轉存到我們自己的 CDN（`https://platform.cdn.xhuoapi.ai/suno/{task_id}.wav`），返回的 `file_url` 即為轉存後的穩定地址，不會因為上游 CDN 過期立即失效。
> **轉存後的連結有效期為 30 天**，超過 30 天後該檔案會被定期清理，建議盡快下載並妥善保存到自己的儲存中。
> 轉存失敗時（極少見），會回退到原始上游 URL，行為與歷史保持一致。