下载音频文件

将已有歌曲下载为 MP3、M4A 或 WAV。替代已下架的 suno-wav。
本模型无版本维度，不要传 version。
用源任务 task_id + audio_index（默认 1）指定要下载的歌曲。源须已完成且含可下载音轨；歌词、BPM 等纯文本任务无法下载。
formats（数组）与 format（单数）二选一；两者都空则 400。支持 mp3 / m4a / wav，可一次请求多种格式。
提交返回的是下载任务 task_id，与源歌曲 task_id 不同。完成后读取 result.files[]（format + url）。result.wavUrl 仅兼容旧接口，新代码不要用。
提交接口：统一通过 POST /v1/music/generations 提交，使用 model: "suno-download" 选择此能力。
任务查询：提交返回 task_id，通过 GET /v1/music/generations/{task_id} 获取任务状态和结果。

Authorization

BearerAuth

AuthorizationBearer <token>

使用 MAPI Bearer Token 认证。格式：Authorization: Bearer sk-xxxxxx。

In: header

Request Body

application/json

model*string

固定填写 suno-download。

task_id*string

源歌曲任务 ID，必填。须已完成且含可下载音轨。

audio_index?integer

源任务 music[] 第几首，1-based，默认 1。

Default1

Range1 <= value

formats?array<string>

要下载的格式数组，至少一项。可与 format 二选一。

Items1 <= items

format?string

只下载一种格式时可用本字段代替 formats。

Value in"mp3" | "m4a" | "wav"

Response Body

application/json

curl -X POST "https://loading/v1/music/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-download",
    "task_id": "task_source123",
    "audio_index": 1,
    "formats": [
      "mp3",
      "wav"
    ]
  }'

curl -X POST "https://loading/v1/music/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "suno-download",    "task_id": "task_source123",    "audio_index": 1,    "formats": [      "mp3",      "wav"    ]  }'

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "status": "submitted",
      "task_id": "task_aehCmxJ5YUNOIQGgkhvxaco4T9P2h3Dw"
    }
  ]
}

{
  "code": "invalid_request",
  "message": "suno-download requires at least one format (use 'formats' or 'format')",
  "data": null
}

Authorization

Request Body

Response Body

200application/json

400application/json

application/json

application/json