SunoAPI(通用)
    • 生成音乐
      POST
    • 生成音乐(V2)
      POST
    • 任务查询
      POST
    • 任务批量查询
      POST
    • 生成歌词
      POST
    • 优化提示词
      POST
    • 上报参考音乐(阻塞)
      POST
    • 上报参考音乐(异步)
      POST
    • 获取上报结果(异步)
      POST
    • 上报参考音乐(Deprecated)
      POST
    • 查询剩余积分
      POST
    • 查询服务状态
      POST
    • 生成人设
      POST
    • 获取人设
      POST
    • 创建角色(Deprecated)
      POST
    • 生成WAV
      POST
    • 获取WAV
      POST
    • 获取时间轴歌词
      POST
    • 获取波形数据
      POST
    • 生成MP4
      POST
    • 获取MP4
      POST
    • 开始分离
      POST
    • 查询分离状态
      POST
    • 生成MIDI
      POST
    • 获取MIDI
      POST
    • 临时token
      POST

      获取上报结果(异步)

      POST
      https://suno.x-mi.cn/apiclouds/v1/suno/queryUploadResult
      异步获取,需要定时查询获取结果,建议5秒以上查询一次,一般是2分钟左右内生成完成

      请求参数

      Header 参数

      Body 参数application/json

      示例
      {
        "queryId": "e33f7bf7-3916-407d-961d-e57b394eb635"
      }

      请求示例代码

      Shell
      JavaScript
      Java
      Swift
      Go
      PHP
      Python
      HTTP
      C
      C#
      Objective-C
      Ruby
      OCaml
      Dart
      R
      请求示例请求示例
      Shell
      JavaScript
      Java
      Swift
      curl --location --request POST 'https://suno.x-mi.cn/apiclouds/v1/suno/queryUploadResult' \
      --header 'x-apiid: 155007609383837293' \
      --header 'x-token: sk-BFC648DFDAF84AE994F78485BB130B3F' \
      --header 'Content-Type: application/json' \
      --data-raw '{
        "queryId": "e33f7bf7-3916-407d-961d-e57b394eb635"
      }'

      返回响应

      🟢200成功
      application/json
      Body

      示例
      {
          "code": 0,
          "msg": "OK",
          "data": {
              "id": 417518,
              "userId": 155182347209275001,
              "channelId": 6555,
              "title": "a13f633f-7c80-40f2-a340-92ae3052b9c4.mp3",
              "style": "Mandopop ballad featuring a clean piano and a male tenor vocal. The arrangement begins with a solo piano playing a melodic, arpeggiated accompaniment. A cello enters during the first verse, providing sustained low-frequency support. The chorus introduces a full pop-rock ensemble including a standard drum kit with a prominent snare on beats 2 and 4, an electric bass playing root notes, and layered acoustic and electric guitars. Orchestral string pads swell during the transitions. The vocal performance transitions from a soft, breathy delivery in the verses to a powerful, belted chest voice in the choruses, occasionally utilizing falsetto for melodic leaps. The tempo is approximately 72 BPM in 4/4 time, likely in the key of C Major.",
              "mvVersion": "chirp-v4",
              "lyric": "[Intro]\n[melodic piano arpeggio]\n(Ooh...)\n\n[Verse 1]\n[piano continues, cello enters]\n這一次鬆開你的手\n也許一別就是永久\n兩個淚人不停抽泣\n祝福的話語怎麼也說不夠\n\n[Verse 2]\n[female vocal harmony enters briefly]\n這一次放開你的手\n也許再也不能祈求\n兩個淚人訴著衷腸\n滾燙的熱情怎麼也抱不夠\n\n[Chorus]\n[full band enters: drums, bass, acoustic guitar]\n離開我的人吶你不要淚流\n我也沒有辦法將你繼續挽留\n以後我不能守在你的身邊\n前方的路要靠你自己去走\n[strings swell]\n離開我的人吶你不要憂愁\n再也沒有辦法陪在你左右\n前方的路有很多磕磕碰碰\n我只能站在原地為你祈求\n\n[Bridge]\n[drums and bass drop out, piano and strings only]\n這一次鬆開你的手\n也許一別就是永久\n兩個淚人不停抽泣\n祝福的話語怎麼也說不夠\n\n[Chorus]\n[full band re-enters, high energy]\n離開我的人吶你不要淚流\n我也沒有辦法將你繼續挽留\n以後我不能守在你的身邊\n前方的路要靠你自己去走\n[vocal belting]\n離開我的人吶你不要憂愁\n再也沒有辦法陪在你左右\n前方的路有很多磕磕碰碰\n我只能站在原地為你祈求\n\n[Outro]\n[instruments fade to solo piano]\n(Ooh...)\n[final piano chord]",
              "clipId": "c3702298-b188-4f21-a5de-41751b8a9869",
              "clipDuration": "222.19997916666668",
              "audioUrl": "https://cdn1.suno.ai/c3702298-b188-4f21-a5de-41751b8a9869.mp3",
              "videoUrl": "",
              "coverUrl": "https://cdn2.suno.ai/image_c3702298-b188-4f21-a5de-41751b8a9869.jpeg",
              "ossVideoUrl": null,
              "ossAudioUrl": "https://oss.suno.x-mi.cn/ti-mi.cn/music/suno/2026-04-08/c3702298-b188-4f21-a5de-41751b8a9869.mp3",
              "ossCoverUrl": "https://oss.suno.x-mi.cn/ti-mi.cn/music/suno/2026-04-08/image_c3702298-b188-4f21-a5de-41751b8a9869.jpeg",
              "state": "complete"
          },
          "traceId": null,
          "success": true
      }
      修改于 2026-04-08 13:49:28
      上一页
      上报参考音乐(异步)
      下一页
      上报参考音乐(Deprecated)
      Built with