> ## 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，行为与历史保持一致。