Przejdź do głównej treści

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 的对接方法。 该 API 核心输入参数是 audio_id，它是官方生成的歌曲ID；可选还支持 callback_url 异步回调地址。 这里我们输入的 audio_id 是 4e43116a-bf09-472c-8e1c-655eabf02682。 
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)
Результат выглядит следующим образом: 
{
  "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，行为与历史保持一致。