1. Suno
梧柏API使用文档
WHBAI · Suno
  • WHBAI · Google Gemini 原生 (v1alpha)
  • WHBAI · Google Gemini 原生
  • WHBAI · Ideogram
  • WHBAI · Ideogram V3
  • WHBAI · Midjourney
  • WHBAI · Jimeng
  • WHBAI · Kling
  • WHBAI · Luma
  • WHBAI · Luma V1
  • WHBAI · Omni 视频
  • WHBAI · Pixverse
  • WHBAI · Runway
  • WHBAI · Sora2
  • WHBAI · 统一视频 VEO
  • WHBAI · Vidu
  • WHBAI · 豆包 Volc
  • WHBAI · Suno
  • WHBAI · Playground
  • WHBAI · 账号与令牌
  • WHBAI · 阿里 Pix
  • WHBAI · 阿里百炼
  • WHBAI · 私域人像
  • WHBAI · Fal.ai
  • WHBAI · Replicate
  • WHBAI · 腾讯云 VOD
  • WHBAI · MiniMax
  • WHBAI · 支持模型列表
  • WHBAI · Grok Imagine
  • WHBAI · Seedance 2.0
  • WHBAI · TypeSafe
  • WHBAI · OpenAI 兼容
  • 文生音乐
    • Suno
      • 创建音乐
        POST
      • 查询任务状态
        POST
      • 查询单个任务
        GET
      • 生成歌曲(拼接歌曲)
        POST
      • 创建歌手风格(Persona)
        POST
      • 生成歌词
        POST
      • 提升音乐风格
        POST
      • Timing:歌词、音频时间线
        GET
      • 获取wav
        GET
      • 我的音乐列表
        GET
      • 生成 MIDI
        GET
      • 波形图数据
        GET
      • MP4 生成状态
        GET
      • 获取音乐风格
        GET
      • 人声/伴奏分离(clipId)
        POST
      • 人声/伴奏分离(URL)
        POST
      • 全轨12路分离(clipId)
        POST
      • 全轨12路分离(URL)
        POST
      • 生成 MP4 视频
        POST
      • 重新生成封面图
        POST
      • 调整播放速度
        POST
      • 修改标题/封面
        POST
      • Fade 淡入淡出
        POST
      • 资源转临时地址
        POST
    • Suno 上传
      • 上传版权歌曲
    • Suno 账户
      • 账户积分余额
  • 数据模型
    • SunoSubmitMusicRequest
    • SunoSubmitMusicResponse
    • SunoFetchRequest
    • SunoTaskData
    • SunoTaskResponse
    • SunoFetchResponse
    • metadataParams
    • PostSunoSubmitPersonaRequest
    • PostSunoUploadsAudioRequest
    • PostSunoSubmitStemsRequest
    • PostSunoSubmitStemsResponse
    • PostSunoSubmitStemsByUrlResponse
    • PostSunoSubmitStemsAllResponse
    • PostSunoSubmitStemsAllByUrlResponse
    • PostSunoSubmitMp4Response
    • PostSunoSubmitRegenImgResponse
    • PostSunoSubmitAdjustSpeedRequest
    • PostSunoSubmitSetMetadataRequest
    • PostSunoSubmitFadeRequest
    • NewApiError
  1. Suno

获取音乐风格

GET
/suno/act/music-style
查询账号下的音乐风格/作品列表(Open 渠道)。

网站中的模型与调用示例#

获取音乐风格#

响应示例 · 成功#

{
  "code": 200,
  "data": [
    {
      "cld2AudioUrl": "https://cdn1.suno.ai/9fbef640-3a1e-49a0-8240-1e4491392c77.mp3",
      "cld2ImageUrl": "https://cdn2.suno.ai/image_9fbef640-3a1e-49a0-8240-1e4491392c77.jpeg",
      "cld2VideoUrl": "",
      "clipId": "9fbef640-3a1e-49a0-8240-1e4491392c77",
      "createTime": "2026-06-12T14:43:12.000+08:00",
      "duration": 114.8,
      "gptDescriptionPrompt": "一首轻快的爵士钢琴曲,适合咖啡厅背景",
      "id": "2065324014708158466",
      "inputType": "10",
      "makeInstrumental": false,
      "progress": 100,
      "progressMsg": "Production completed",
      "prompt": "[Instrumental]",
      "status": 30,
      "tags": "Jazz piano instrumental, light upbeat swing feel with brushed ride cymbal, walking bass, and crisp syncopated left-hand comping; intro starts with solo piano and coffee-shop room tone, verse section adds bass and soft brushes, middle lifts with bright passing chords and a playful turnaround, final section opens with fuller piano flourishes and a gentle tag. Close, intimate piano tone with warm vintage glow, subtle vinyl crackle, and a clean, cozy mix.",
      "title": "午后咖啡杯",
      "waitNum": 0
    },
    {
      "cld2AudioUrl": "https://cdn1.suno.ai/227c8897-2216-45eb-83bd-70e52375027d.mp3",
      "cld2ImageUrl": "https://cdn2.suno.ai/image_227c8897-2216-45eb-83bd-70e52375027d.jpeg",
      "cld2VideoUrl": "",
      "clipId": "227c8897-2216-45eb-83bd-70e52375027d",
      "createTime": "2026-06-12T14:43:12.000+08:00",
      "duration": 96.36,
      "gptDescriptionPrompt": "一首轻快的爵士钢琴曲,适合咖啡厅背景",
      "id": "2065324014708158465",
      "inputType": "10",
      "makeInstrumental": false,
      "progress": 100,
      "progressMsg": "Production completed",
      "prompt": "[Instrumental]",
      "status": 30,
      "tags": "Jazz piano instrumental, light upbeat swing feel with brushed ride cymbal, walking bass, and crisp syncopated left-hand comping; intro starts with solo piano and coffee-shop room tone, verse section adds bass and soft brushes, middle lifts with bright passing chords and a playful turnaround, final section opens with fuller piano flourishes and a gentle tag. Close, intimate piano tone with warm vintage glow, subtle vinyl crackle, and a clean, cozy mix.",
      "title": "午后咖啡杯",
      "waitNum": 0
    },
    {
      "cld2AudioUrl": "https://cdn1.suno.ai/6c45fcd7-457f-4616-b7b6-6e21cf0372b4.mp3",
      "cld2ImageUrl": "https://cdn2.suno.ai/image_6c45fcd7-457f-4616-b7b6-6e21cf0372b4.jpeg",
      "cld2VideoUrl": "",
      "clipId": "6c45fcd7-457f-4616-b7b6-6e21cf0372b4",
      "createTime": "2026-06-12T14:25:05.000+08:00",
      "duration": 44.52,
      "id": "2065319458364276738",
      "inputType": "fade",
      "progress": 100,
      "progressMsg": "Production completed",
      "prompt": "[Intro]\n[staccato synth riff, palm-muted electric guitar, steady kick drum]\nDa da da da da da da da\nDa da da da da da da da\n[snare enters]\nHey!\n[falsetto vocalization]\nOh\nYeah\nDa da da da da da da da\nDa da da da da da da da\nDa da da da da da da da\nDa da\n\n[Verse 1]\n[bass guitar enters]\n太阳爬上双肩带\nDa da da da da da da da\nDa da da da da da da da\n太阳爬上双肩带\nDa da da da da da da da\nDa da da da da da da da",
      "status": 30,
      "tags": "Mandopop with electronic and rock elements. A clean electric guitar plays a syncopated, palm-muted rhythmic pattern alongside a bright, staccato synthesizer riff. The drums feature a crisp snare and a steady kick. A female vocalist performs with a clear, melodic tone, utilizing falsetto during the chorus. The bass guitar follows the kick drum with a rounded, warm tone. The arrangement includes layered vocal harmonies and occasional synth swells. Key of G Major, 128 BPM.",
      "title": "参考音频 (Fade In)"
    },
    {
      "cld2AudioUrl": "https://file.dzwlai.com/suno/music/api/000/047/722/1272194363468537857.mp3",
      "cld2ImageUrl": "https://cdn2.suno.ai/image_a3911719-eded-4585-a4bb-90ea52d786b5.jpeg",
      "clipId": "421054bd-8721-4b63-8aef-e863bb1ee991",
      "createTime": "2026-06-12T14:06:13.000+08:00",
      "duration": 148.36,
      "gptDescriptionPrompt": "https://cdn1.suno.ai/a3911719-eded-4585-a4bb-90ea52d786b5.mp3",
      "id": "2065314707077820418",
      "inputType": "adjustSpeed",
      "progress": 100,
      "progressMsg": "Production completed",
      "prompt": "[Instrumental]",
      "status": 30,
      "tags": "Jazz piano instrumental with a light bouncy swing feel, brushed-swing rhythm and walking bass; intro opens on solo upright piano with soft room tone, verse-like sections add brushed drums and a warm bass pulse, then a small chorus lift brings brighter piano runs and syncopated chord hits before settling back into a gentle outro. Sparse tasteful fills, occasional glockenspiel sparkles, subtle vinyl crackle, intimate close-mic and cozy café mix.",
      "title": "咖啡杯边(1.5x)"
    },
    {
      "cld2AudioUrl": "https://cdn1.suno.ai/beda6002-727e-4ad6-b10b-0923dc35a381.mp3",
      "cld2ImageUrl": "https://cdn2.suno.ai/image_beda6002-727e-4ad6-b10b-0923dc35a381.jpeg",
      "cld2VideoUrl": "",
      "clipId": "beda6002-727e-4ad6-b10b-0923dc35a381",
      "createTime": "2026-06-12T11:55:43.000+08:00",
      "duration": 103.92,
      "gptDescriptionPrompt": "一首轻快的爵士钢琴曲,适合咖啡厅背景",
      "id": "2065281868781285379",
      "inputType": "10",
      "makeInstrumental": false,
      "progress": 100,
      "progressMsg": "Production completed",
      "prompt": "[Instrumental]",
      "status": 30,
      "tags": "Jazz piano instrumental with a light bouncy swing feel, brushed-swing rhythm and walking bass; intro opens on solo upright piano with soft room tone, verse-like sections add brushed drums and a warm bass pulse, then a small chorus lift brings brighter piano runs and syncopated chord hits before settling back into a gentle outro. Sparse tasteful fills, occasional glockenspiel sparkles, subtle vinyl crackle, intimate close-mic and cozy café mix.",
      "title": "咖啡杯边",
      "waitNum": 0
    },
    {
      "cld2AudioUrl": "https://cdn1.suno.ai/a3911719-eded-4585-a4bb-90ea52d786b5.mp3",
      "cld2ImageUrl": "https://cdn2.suno.ai/image_a3911719-eded-4585-a4bb-90ea52d786b5.jpeg",
      "cld2VideoUrl": "https://cdn1.suno.ai/a3911719-eded-4585-a4bb-90ea52d786b5.mp4",
      "clipId": "a3911719-eded-4585-a4bb-90ea52d786b5",
      "createTime": "2026-06-12T11:55:43.000+08:00",
      "duration": 148.36,
      "gptDescriptionPrompt": "一首轻快的爵士钢琴曲,适合咖啡厅背景",
      "id": "2065281868781285378",
      "inputType": "10",
      "makeInstrumental": false,
      "progress": 100,
      "progressMsg": "Production completed",
      "prompt": "[Instrumental]",
      "status": 30,
      "tags": "Jazz piano instrumental with a light bouncy swing feel, brushed-swing rhythm and walking bass; intro opens on solo upright piano with soft room tone, verse-like sections add brushed drums and a warm bass pulse, then a small chorus lift brings brighter piano runs and syncopated chord hits before settling back into a gentle outro. Sparse tasteful fills, occasional glockenspiel sparkles, subtle vinyl crackle, intimate close-mic and cozy café mix.",
      "title": "咖啡杯边",
      "waitNum": 0
    },
    {
      "cld2AudioUrl": "https://cdn1.suno.ai/bfad77a3-7aee-4ac0-a140-b084697d2048.mp3",
      "cld2ImageUrl": "https://cdn2.suno.ai/image_bfad77a3-7aee-4ac0-a140-b084697d2048.jpeg",
      "cld2VideoUrl": "",
      "clipId": "bfad77a3-7aee-4ac0-a140-b084697d2048",
      "createTime": "2026-06-05T10:13:55.000+08:00",
      "duration": 184.96,
      "gptDescriptionPrompt": "轻快的 pop 测试",
      "id": "2062719535512956930",
      "inputType": "10",
      "makeInstrumental": false,
      "progress": 100,
      "progressMsg": "Production completed",
      "prompt": "[Verse 1]\n我把门一推开\n风就先跑进来\n今天不想发呆\n想把心跳翻出来\n\n鞋带随便一系\n烦恼先放一边\n你看我笑一笑\n连空气都变甜\n\n[Pre-Chorus]\n别问我为什么\n我也说不出来\n就是想跟着节拍\n往前走别停摆\n\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消息叮咚一响\n原来是你在问\n要不要出来走走\n顺路去看黄昏\n\n[Pre-Chorus]\n别问我为什么\n我也说不出来\n就是想跟着节拍\n往前走别停摆\n\n眼睛里有光\n手心里有火花\n下一秒就要\n把快乐放大\n\n[Chorus]\n轻快一点\n轻快一点\n今天就要轻快一点\n\n跟我转圈\n跟我转圈\n把难过都转远一点\n\n轻快一点\n轻快一点\n心里开出一片天\n\n你一出现\n我就想要\n轻快一点\n\n[Bridge]\n把昨天折起来\n塞进抽屉里\n让新的风\n吹过来\n\n你笑一下\n世界就软下来\n我们一起\n慢慢来\n\n[Final Chorus]\n轻快一点\n轻快一点\n今天就要轻快一点\n\n跟我转圈\n跟我转圈\n把难过都转远一点\n\n轻快一点\n轻快一点\n心里开出一片天\n\n你在身边\n我就想要\n轻快一点",
      "status": 30,
      "tags": "Pop with bright four-on-the-floor pulse and syncopated handclaps; verse rides light synth plucks and tight bass, pre-chorus pulls back to filtered pads and rising percussion, chorus opens wide with stacked harmonies and a chantable hook. Lead vocal stays close-mic and playful with doubled chorus lines, little breathy ad-libs, and short delay throws on the hook word. Use sparkling risers, reversed swells, and a tiny bell sparkle between phrases. Bright, glossy, radio-ready mix with punchy low end., pop",
      "title": "风吹小测试",
      "waitNum": 0
    },
    {
      "cld2AudioUrl": "https://cdn1.suno.ai/d0c1b22f-8959-4d9f-836b-d8bd7b47fdac.mp3",
      "cld2ImageUrl": "https://cdn2.suno.ai/image_d0c1b22f-8959-4d9f-836b-d8bd7b47fdac.jpeg",
      "cld2VideoUrl": "",
      "clipId": "d0c1b22f-8959-4d9f-836b-d8bd7b47fdac",
      "createTime": "2026-06-05T10:13:55.000+08:00",
      "duration": 171.12,
      "gptDescriptionPrompt": "轻快的 pop 测试",
      "id": "2062719535512956929",
      "inputType": "10",
      "makeInstrumental": false,
      "progress": 100,
      "progressMsg": "Production completed",
      "prompt": "[Verse 1]\n我把门一推开\n风就先跑进来\n今天不想发呆\n想把心跳翻出来\n\n鞋带随便一系\n烦恼先放一边\n你看我笑一笑\n连空气都变甜\n\n[Pre-Chorus]\n别问我为什么\n我也说不出来\n就是想跟着节拍\n往前走别停摆\n\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消息叮咚一响\n原来是你在问\n要不要出来走走\n顺路去看黄昏\n\n[Pre-Chorus]\n别问我为什么\n我也说不出来\n就是想跟着节拍\n往前走别停摆\n\n眼睛里有光\n手心里有火花\n下一秒就要\n把快乐放大\n\n[Chorus]\n轻快一点\n轻快一点\n今天就要轻快一点\n\n跟我转圈\n跟我转圈\n把难过都转远一点\n\n轻快一点\n轻快一点\n心里开出一片天\n\n你一出现\n我就想要\n轻快一点\n\n[Bridge]\n把昨天折起来\n塞进抽屉里\n让新的风\n吹过来\n\n你笑一下\n世界就软下来\n我们一起\n慢慢来\n\n[Final Chorus]\n轻快一点\n轻快一点\n今天就要轻快一点\n\n跟我转圈\n跟我转圈\n把难过都转远一点\n\n轻快一点\n轻快一点\n心里开出一片天\n\n你在身边\n我就想要\n轻快一点",
      "status": 30,
      "tags": "Pop with bright four-on-the-floor pulse and syncopated handclaps; verse rides light synth plucks and tight bass, pre-chorus pulls back to filtered pads and rising percussion, chorus opens wide with stacked harmonies and a chantable hook. Lead vocal stays close-mic and playful with doubled chorus lines, little breathy ad-libs, and short delay throws on the hook word. Use sparkling risers, reversed swells, and a tiny bell sparkle between phrases. Bright, glossy, radio-ready mix with punchy low end., pop",
      "title": "风吹小测试",
      "waitNum": 0
    },
    {
      "cld2AudioUrl": "https://cdn1.suno.ai/518d910f-a6b7-43fc-9f65-c9f116f3f8a3.mp3",
      "cld2ImageUrl": "https://cdn2.suno.ai/image_518d910f-a6b7-43fc-9f65-c9f116f3f8a3.jpeg",
      "createTime": "2026-06-05T09:51:56.000+08:00",
      "duration": 216.56,
      "id": "2062714000214470658",
      "inputType": "createPersona",
      "progressMsg": "Production completed",
      "prompt": "[前奏]\n[主歌]\n周四的阳光晒脸庞\n微风轻轻吹过窗\n朋友们聚会唱歌忙\n笑声在空中飘荡\n\n\n[主歌]\n草地铺开花儿香\n大家围坐一圈旁\n吉他弹起旋律长\n快乐就这样流淌\n\n\n[副歌]\n周四快乐不散场\n欢声笑语满心房\n朋友相聚真难忘\n幸福时光永不忘\n\n\n[主歌]\n夜幕降临星光亮\n篝火边跳起舞蹈\n忘掉烦恼心情畅\n这天就是我们的宝\n\n\n[主歌]\n啤酒冰凉手心暖\n谈笑风生话语绵\n明天再忙也要嗨\n周四快乐是永远\n\n\n[预副歌]\n回忆往昔笑语甜\n未来还有更多精彩\n周四快乐每一天\n让生活充满色彩\n\n\n[副歌]\n周四快乐不散场\n欢声笑语满心房\n朋友相聚真难忘\n幸福时光永不忘\n",
      "result": {
        "artist_clip_id": "820fbb29-78fc-4b16-942c-34b2978c80e6",
        "name": "为你歌唱",
        "persona_id": "273afb09-71d4-4104-9e2e-244eae272bec"
      },
      "status": 30,
      "tags": "pop,female voice",
      "title": "为你歌唱"
    },
    {
      "cld2AudioUrl": "https://cdn1.suno.ai/518d910f-a6b7-43fc-9f65-c9f116f3f8a3.mp3",
      "cld2ImageUrl": "https://cdn2.suno.ai/image_518d910f-a6b7-43fc-9f65-c9f116f3f8a3.jpeg",
      "createTime": "2026-06-05T09:41:48.000+08:00",
      "duration": 216.56,
      "id": "2062711452644552705",
      "inputType": "createPersona",
      "progressMsg": "Production completed",
      "prompt": "[前奏]\n[主歌]\n周四的阳光晒脸庞\n微风轻轻吹过窗\n朋友们聚会唱歌忙\n笑声在空中飘荡\n\n\n[主歌]\n草地铺开花儿香\n大家围坐一圈旁\n吉他弹起旋律长\n快乐就这样流淌\n\n\n[副歌]\n周四快乐不散场\n欢声笑语满心房\n朋友相聚真难忘\n幸福时光永不忘\n\n\n[主歌]\n夜幕降临星光亮\n篝火边跳起舞蹈\n忘掉烦恼心情畅\n这天就是我们的宝\n\n\n[主歌]\n啤酒冰凉手心暖\n谈笑风生话语绵\n明天再忙也要嗨\n周四快乐是永远\n\n\n[预副歌]\n回忆往昔笑语甜\n未来还有更多精彩\n周四快乐每一天\n让生活充满色彩\n\n\n[副歌]\n周四快乐不散场\n欢声笑语满心房\n朋友相聚真难忘\n幸福时光永不忘\n",
      "result": {
        "artist_clip_id": "820fbb29-78fc-4b16-942c-34b2978c80e6",
        "name": "为你歌唱",
        "persona_id": "273afb09-71d4-4104-9e2e-244eae272bec"
      },
      "status": 30,
      "tags": "pop,female voice",
      "title": "为你歌唱"
    }
  ],
  "msg": "操作成功",
  "total": 17
}

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/suno/act/music-style' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": 200,
    "msg": "操作成功",
    "total": 1,
    "data": [
        {
            "id": "2065324014708158466",
            "title": "午后咖啡杯",
            "status": 30,
            "duration": 114.8,
            "clipId": "9fbef640-3a1e-49a0-8240-1e4491392c77",
            "cld2AudioUrl": "https://cdn1.suno.ai/9fbef640-3a1e-49a0-8240-1e4491392c77.mp3",
            "cld2ImageUrl": "https://cdn2.suno.ai/image_9fbef640-3a1e-49a0-8240-1e4491392c77.jpeg"
        }
    ]
}
🟠401没有权限
修改于 2026-10-24 18:33:20
上一页
MP4 生成状态
下一页
人声/伴奏分离(clipId)
Built with