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/batchQuery

      请求参数

      Header 参数

      Body 参数application/json

      示例
      {
          "ids":["157416141350909256","157280144442235543","157275661642845617"]
      }

      请求示例代码

      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/batchQuery' \
      --header 'x-apiid: 157421530141757546' \
      --header 'x-token: sk-5978942F901D4FD9915F4FBEA12C98D9' \
      --header 'Content-Type: application/json' \
      --data-raw '{
          "ids":["157416141350909256","157280144442235543","157275661642845617"]
      }'

      返回响应

      🟢200成功
      application/json
      Body

      示例
      {
          "code": 0,
          "msg": "OK",
          "data": [
              {
                  "id": "157416141350909256",
                  "status": 30,
                  "errMsg": null,
                  "list": [
                      {
                          "id": 7957162,
                          "clipId": "c56ae753-a6d1-42d8-92d6-fc4c91483fbd",
                          "clipDuration": "202.52",
                          "lyric": "[Verse 1]\n瓦檐下一串风铃\n小巷深处卖花声\n纸伞靠在老门楣\n猫睡在竹影里头轻打鼾\n\n茶汤一点点透亮\n日光慢慢走过窗\n书页翻到旧题跋\n墨香和桂花一起晕在傍晚\n\n[Chorus]\n就这样吧 一盏茶\n看云爬过屋脊 慢慢融进天涯\n不去问啊 人海答\n只将三分清醒 换几两闲话\n\n就这样吧 一盏茶\n让时光停在杯沿 不再催我长大\n任由头发 乱成画\n有歌便轻声和 没歌就听花\n\n[Verse 2]\n街头棋局围着笑\n谁赢谁输都不吵\n老人打个小酒嗝\n说起年轻时走到海角天高\n\n河里洗衣的人唱\n拍子随水漫过桥\n孩童追着木叶跑\n捡到一片秋色举到我手掌\n\n[Chorus]\n就这样吧 一盏茶\n看云爬过屋脊 慢慢融进天涯\n不去问啊 人海答\n只将三分清醒 换几两闲话\n\n就这样吧 一盏茶\n让时光停在杯沿 不再催我长大\n任由头发 乱成画\n有歌便轻声和 没歌就听花\n\n[Bridge]\n人生多半是匆匆\n偶尔也该装装懒虫\n把明日的重担\n挂到竹竿上晒一晒晚风\n\n[Chorus]\n就这样吧 一盏茶\n看云爬过屋脊 慢慢融进天涯\n不去问啊 人海答\n只将三分清醒 换几两闲话\n\n就这样吧 一盏茶\n若你恰好路过 坐下陪我说话\n等到夕霞 捧红瓦\n我们把这盏喝尽 也算到过家",
                          "title": "闲云一盏茶",
                          "style": "Gentle guzheng and xiao over soft hand drums; male vocals in an unhurried, storytelling tone. Verses stay close and intimate, like a courtyard performance; chorus widens with light backing harmonies and warm strings. Subtle dynamic lift into each hook, then landing back into a relaxed, swaying groove.",
                          "mvVersion": "v5",
                          "audioUrl": "https://oss.suno.x-mi.cn/ti-mi.cn/music/suno/2026-03-21/c56ae753-a6d1-42d8-92d6-fc4c91483fbd.mp3",
                          "videoUrl": null,
                          "coverUrl": "https://oss.suno.x-mi.cn/ti-mi.cn/music/suno/2026-03-21/image_c56ae753-a6d1-42d8-92d6-fc4c91483fbd.jpeg",
                          "resultMark": 10,
                          "resultMarkMsg": null,
                          "state": "complete",
                          "progress": "100%",
                          "continueFlag": true,
                          "wavFlag": true,
                          "songCategoryName": "-",
                          "songCategoryId": -1
                      },
                      {
                          "id": 7957163,
                          "clipId": "c83789f0-8517-4eb3-a91d-9bcfeee1f6cf",
                          "clipDuration": "182.64",
                          "lyric": "[Verse 1]\n瓦檐下一串风铃\n小巷深处卖花声\n纸伞靠在老门楣\n猫睡在竹影里头轻打鼾\n\n茶汤一点点透亮\n日光慢慢走过窗\n书页翻到旧题跋\n墨香和桂花一起晕在傍晚\n\n[Chorus]\n就这样吧 一盏茶\n看云爬过屋脊 慢慢融进天涯\n不去问啊 人海答\n只将三分清醒 换几两闲话\n\n就这样吧 一盏茶\n让时光停在杯沿 不再催我长大\n任由头发 乱成画\n有歌便轻声和 没歌就听花\n\n[Verse 2]\n街头棋局围着笑\n谁赢谁输都不吵\n老人打个小酒嗝\n说起年轻时走到海角天高\n\n河里洗衣的人唱\n拍子随水漫过桥\n孩童追着木叶跑\n捡到一片秋色举到我手掌\n\n[Chorus]\n就这样吧 一盏茶\n看云爬过屋脊 慢慢融进天涯\n不去问啊 人海答\n只将三分清醒 换几两闲话\n\n就这样吧 一盏茶\n让时光停在杯沿 不再催我长大\n任由头发 乱成画\n有歌便轻声和 没歌就听花\n\n[Bridge]\n人生多半是匆匆\n偶尔也该装装懒虫\n把明日的重担\n挂到竹竿上晒一晒晚风\n\n[Chorus]\n就这样吧 一盏茶\n看云爬过屋脊 慢慢融进天涯\n不去问啊 人海答\n只将三分清醒 换几两闲话\n\n就这样吧 一盏茶\n若你恰好路过 坐下陪我说话\n等到夕霞 捧红瓦\n我们把这盏喝尽 也算到过家",
                          "title": "闲云一盏茶",
                          "style": "Gentle guzheng and xiao over soft hand drums; male vocals in an unhurried, storytelling tone. Verses stay close and intimate, like a courtyard performance; chorus widens with light backing harmonies and warm strings. Subtle dynamic lift into each hook, then landing back into a relaxed, swaying groove.",
                          "mvVersion": "v5",
                          "audioUrl": "https://oss.suno.x-mi.cn/ti-mi.cn/music/suno/2026-03-21/c83789f0-8517-4eb3-a91d-9bcfeee1f6cf.mp3",
                          "videoUrl": null,
                          "coverUrl": "https://oss.suno.x-mi.cn/ti-mi.cn/music/suno/2026-03-21/image_c83789f0-8517-4eb3-a91d-9bcfeee1f6cf.jpeg",
                          "resultMark": 10,
                          "resultMarkMsg": null,
                          "state": "complete",
                          "progress": "100%",
                          "continueFlag": true,
                          "wavFlag": true,
                          "songCategoryName": "-",
                          "songCategoryId": -1
                      }
                  ]
              },
              {
                  "id": "157280144442235543",
                  "status": 30,
                  "errMsg": null,
                  "list": [
                      {
                          "id": 7491557,
                          "clipId": "e56dc61f-55c2-4c42-a883-73d247cd9be9",
                          "clipDuration": "289.8",
                          "lyric": "[Verse 1]\n你真的残酷吗\n或者温柔才是可耻的\n或者孤独的人无所谓\n无知无叶无条件\n前面真的威胁吗\n或者背叛才是体贴的\n或者逃避比较容易吧\n风言风语风吹沙\n\n[Pre-Chorus]\n向前一步是黄昏\n退后一步是人生\n风不平浪不静心还不安稳\n一个岛锁住一个人\n\n[Chorus]\n我等得船还不来\n我等的人还不明白\n寂寞默默沉没沉入海\n未来不在我还在\n如果超去心也去\n如果潮来你还不来\n浮浮沉沉往事浮上来\n回忆回来你已不在\n一波还未平息\n一波又来侵袭\n茫茫人海狂风暴雨\n一波还来不及\n一波早就过去\n一生一世如梦初醒\n深深太平洋底深深伤心\n\n[Verse 2]\n你真的残酷吗\n或者温柔才是可耻的\n或者孤独的人无所谓\n无知无叶无条件\n\n[Pre-Chorus]\n向前一步是黄昏\n退后一步是人生\n风不平浪不静心还不安稳\n一个岛锁住一个人\n\n[Chorus]\n我等得船还不来\n我等的人还不明白\n寂寞默默沉没沉入海\n回忆回来你已不在\n一波还未平息\n一波又来侵袭\n茫茫人海狂风暴雨\n一波还来不及\n一波早就过去\n一生一世如梦初醒\n深深太平洋底深深伤心\n\n[Guitar Solo]\n(Instrumental)\n\n[Chorus]\n一波还未平息\n一波又来侵袭\n一波还来不及\n一波早就过去\n一生一世如梦初醒\n深深太平洋底深深伤心\n深深太平洋底深深伤心",
                          "title": "我愿意为你",
                          "style": "pop",
                          "mvVersion": "v5",
                          "audioUrl": "https://oss.suno.x-mi.cn/ti-mi.cn/music/suno/2026-01-31/e56dc61f-55c2-4c42-a883-73d247cd9be9.mp3",
                          "videoUrl": null,
                          "coverUrl": "https://oss.suno.x-mi.cn/ti-mi.cn/music/suno/2026-01-31/image_e56dc61f-55c2-4c42-a883-73d247cd9be9.jpeg",
                          "resultMark": 100,
                          "resultMarkMsg": "人设",
                          "state": "complete",
                          "progress": "100%",
                          "continueFlag": true,
                          "wavFlag": true,
                          "songCategoryName": "-",
                          "songCategoryId": -1
                      },
                      {
                          "id": 7491558,
                          "clipId": "911732b0-8dec-487b-8542-8f8fb1a68f46",
                          "clipDuration": "267.08",
                          "lyric": "[Verse 1]\n你真的残酷吗\n或者温柔才是可耻的\n或者孤独的人无所谓\n无知无叶无条件\n前面真的威胁吗\n或者背叛才是体贴的\n或者逃避比较容易吧\n风言风语风吹沙\n\n[Pre-Chorus]\n向前一步是黄昏\n退后一步是人生\n风不平浪不静心还不安稳\n一个岛锁住一个人\n\n[Chorus]\n我等得船还不来\n我等的人还不明白\n寂寞默默沉没沉入海\n未来不在我还在\n如果超去心也去\n如果潮来你还不来\n浮浮沉沉往事浮上来\n回忆回来你已不在\n一波还未平息\n一波又来侵袭\n茫茫人海狂风暴雨\n一波还来不及\n一波早就过去\n一生一世如梦初醒\n深深太平洋底深深伤心\n\n[Verse 2]\n你真的残酷吗\n或者温柔才是可耻的\n或者孤独的人无所谓\n无知无叶无条件\n\n[Pre-Chorus]\n向前一步是黄昏\n退后一步是人生\n风不平浪不静心还不安稳\n一个岛锁住一个人\n\n[Chorus]\n我等得船还不来\n我等的人还不明白\n寂寞默默沉没沉入海\n回忆回来你已不在\n一波还未平息\n一波又来侵袭\n茫茫人海狂风暴雨\n一波还来不及\n一波早就过去\n一生一世如梦初醒\n深深太平洋底深深伤心\n\n[Guitar Solo]\n(Instrumental)\n\n[Chorus]\n一波还未平息\n一波又来侵袭\n一波还来不及\n一波早就过去\n一生一世如梦初醒\n深深太平洋底深深伤心\n深深太平洋底深深伤心",
                          "title": "我愿意为你",
                          "style": "pop",
                          "mvVersion": "v5",
                          "audioUrl": "https://oss.suno.x-mi.cn/ti-mi.cn/music/suno/2026-01-31/911732b0-8dec-487b-8542-8f8fb1a68f46.mp3",
                          "videoUrl": null,
                          "coverUrl": "https://oss.suno.x-mi.cn/ti-mi.cn/music/suno/2026-01-31/image_911732b0-8dec-487b-8542-8f8fb1a68f46.jpeg",
                          "resultMark": 100,
                          "resultMarkMsg": "人设",
                          "state": "complete",
                          "progress": "100%",
                          "continueFlag": true,
                          "wavFlag": true,
                          "songCategoryName": "-",
                          "songCategoryId": -1
                      }
                  ]
              },
              {
                  "id": "157275661642845617",
                  "status": 40,
                  "errMsg": "生成失败#Your prompt contains artist name kanye - we don't reference specific artists on Suno, please change your prompt and try again.",
                  "list": null
              }
          ],
          "traceId": null,
          "success": true
      }
      修改于 2026-04-06 08:57:43
      上一页
      任务查询
      下一页
      生成歌词
      Built with