SunoAPI(通用)
    • 生成音乐(Deprecated)
      POST
    • 生成音乐(V2)
      POST
    • 任务查询
      POST
    • 任务批量查询
      POST
    • 生成歌词
      POST
    • 优化提示词
      POST
    • 上报参考音乐(阻塞)
      POST
    • 上报参考音乐(异步)
      POST
    • 获取上报结果(异步)
      POST
    • 上报参考音乐(Deprecated)
      POST
    • 查询剩余积分
      POST
    • 查询服务状态
      POST
    • 获取创建人设验证语句
      POST
    • 创建歌手人设
      POST
    • 获取歌手人设
      POST
    • 重新激活歌手人设
      POST
    • 查询歌手人设是否已失效
      POST
    • 生成WAV
      POST
    • 获取WAV
      POST
    • 获取时间轴歌词
      POST
    • 获取波形数据
      POST
    • 生成MP4
      POST
    • 获取MP4
      POST
    • 开始分离
      POST
    • 查询分离状态
      POST
    • 生成MIDI
      POST
    • 获取MIDI
      POST
    • 临时token
      POST
    • 下载MP3
      POST

      下载MP3

      POST
      https://suno.x-mi.cn/apiclouds/v1/suno/downloadAudio
      下载mp3/ m4a等音频,下载成功会返回一个OSS的临时地址,有效期 72小时 。(注:尽快提取)

      请求参数

      Header 参数

      Body 参数application/json

      示例
      {
          "clipId": "88d80aae-1876-4cce-b6f8-163496fe54a6"
      }

      请求示例代码

      Shell
      JavaScript
      Java
      Swift
      Go
      PHP
      Python
      HTTP
      C
      C#
      Objective-C
      Ruby
      OCaml
      Dart
      R
      请求示例请求示例
      Shell
      JavaScript
      Java
      Swift
      curl --location 'https://suno.x-mi.cn/apiclouds/v1/suno/downloadAudio' \
      --header 'x-apiid: 155358095076248003' \
      --header 'x-token: sk-1E04222C99044971AEA4C850D95F6B0F' \
      --header 'Content-Type: application/json' \
      --data '{
          "clipId": "88d80aae-1876-4cce-b6f8-163496fe54a6"
      }'

      返回响应

      🟢200成功
      application/json
      Bodyapplication/json

      示例
      {
          "code": 0,
          "msg": "OK",
          "data": {
              "url": "https://oss.suno.x-mi.cn/suno/download/20260829/88d80aae-1876-4cce-b6f8-163496fe54a6.m4a",
              "clipId": "88d80aae-1876-4cce-b6f8-163496fe54a6",
              "expirationDate": "2026-08-31 09:00:50"
          },
          "success": true
      }
      修改于 2026-09-07 11:58:34
      上一页
      临时token
      Built with