在AI生成内容（AIGC）里，音乐一直是门槛最高、想象力也最自由的领域之一。

而SUNO，几乎是目前最“像真正音乐创作”的文生音乐模型：

• 一句话，就能生成完整歌曲（旋律+编曲+人声+歌词）
• 理解“情绪、风格、画面感”，而不只是标签拼接
• 能唱中文、英文等多语言，并具备稳定的人声表现
• 支持续写、翻版、风格迁移，真正可用于生产级内容

很多人第一次用Suno，都会有类似的感受：

“这已经不是玩具了，而是一个可以被集成进产品的音乐引擎。”

 

---

为什么要用API方式接入Suno？

如果你只是偶尔生成几首歌，网页端已经足够；

但一旦你想要：

• 在自己的网站/App/小程序里生成音乐
• 批量生成、自动化生成
• 把音乐作为AI产品的一部分能力

那么，API调用几乎是唯一选择。

---

神马中转API是什么？

本文使用的并非Suno官方直连接口，而是：

神马中转API（Suno代理API服务）

它的核心价值在于：

• 完整代理Suno能力，功能覆盖官方版本
• 统一REST API形式，调用方式更稳定
• 同时兼容SunoAPI/GoAmz/v3.5模型体系
• 已封装大量高级场景（Persona、stems、Timing等）

也就是说：

你只需要对接「神马中转API（api.whatai.cc）」，就等于对接了Suno的全部能力。

 

---

本教程你能学到什么？

本文将系统性地介绍如何通过「神马中转API」调用Suno实现文生音乐，内容包括：

• Suno文生歌的整体架构与调用流程
• 神马中转API的接入方式与路径说明
• 多种常见生成场景的请求示例
• 关键参数、clip_id、task_id的正确使用方式
• 从“生成一首歌”到“做一个音乐功能模块”的完整思路

不管你是：

• 想做AI音乐产品
• 想在App里加一个「生成歌曲」功能
• 想把Suno当成后端能力集成

这篇文章，都会是一个可以直接照着实现的起点。

---

SUNO文生音乐快速入门

你当前使用的是：

神马中转代理Suno的API服务

核心能力

• 文生歌曲（带歌词/纯音乐）
• 灵感模式/自定义模式
• 续写/翻 /风格迁移
• 歌手Persona
• 声曲分离（Vocals/Instrumental）
• Timing（歌词+时间轴）

核心接口地址

提交生成任务：
POST https://{BASE_URL}/suno/submit/music

查询任务结果：
GET  https://{BASE_URL}/suno/fetch

兼容格式

类型	前缀
SunoAPI	/suno
GoAmz v1	/suno/v1
GoAmz v3.5	/suno/v1/mv-3.5

---

SUNO API基础调用流程（必读）

所有Suno文生歌，本质都是异步任务：

1. 提交生成请求  → 返回 task_id
2. 轮询 fetch 接口 → 查询状态
3. 状态完成后     → 获取音频 / 歌词 / clip_id

核心字段关系：

• task_id：一次生成任务
• clip_id：某一首具体歌曲（非常重要）

---

场景一：灵感模式（最简单）

不提供歌词，由Suno自动生成

示例需求

生成一首「治愈系中文流行歌，关于夜晚和星空」

请求示例

POST /suno/submit/music
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "prompt": "治愈系中文流行，夜晚，星空，温柔",
  "make_instrumental": false,
  "model": "chirp-v3-5",
  "mv": "inspiration"
}

参数说明

参数	说明
prompt	对音乐的自然语言描述
make_instrumental	是否纯音乐
model	推荐使用chirp-v3-5
mv	inspiration=灵感模式

---

场景二：自定义模式（歌词+歌名）

最常用、可控性最高

示例需求

• 歌名：《城市微光》
• 歌词：自定义
• 风格：中文流行+电子

请求示例

POST /suno/submit/music
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "title": "城市微光",
  "lyrics": "\n[Verse]\n霓虹在窗外闪烁\n夜色慢慢降落\n[Chorus]\n我们在城市微光中\n寻找彼此的梦",
  "style": "Mandopop, electronic",
  "model": "chirp-v3-5",
  "mv": "custom"
}

说明

• lyrics支持Suno结构标签（Verse/Chorus等）
• style即tags，可用英文逗号分隔

---

 

场景三：纯音乐（BGM / 配乐）

{
  "prompt": "电影感，史诗，慢节奏，钢琴与弦乐",
  "make_instrumental": true,
  "model": "chirp-v3-5",
  "mv": "custom"
}

适合：

• 游戏BGM
• 视频配乐
• 冥想/氛围音乐

---

场景四：续写音乐（Continuation）

在已有clip基础上继续生成

{
  "clip_id": "a624123d-xxxx",
  "continue_at": 60,
  "model": "chirp-v3-5"
}

• continue_at：从第几秒开始续写

---

Persona：创建歌手风格

固定音色/演唱习惯

POST /suno/persona/create

{
  "clip_id": "已有歌曲的 clip_id",
  "name": "温柔女声"
}

后续生成时直接引用 persona_id

---

声曲分离（Vocals / Instrumental）

POST /suno/stems

{
  "clip_id": "a624123d-xxxx"
}

返回：

• vocals.wav
• instrumental.wav

---

Timing：歌词时间线

GET /suno/timing?clip_id=a624123d-xxxx

适合：

• 卡拉 OK
• 歌词动画
• 剪辑对齐

查询任务结果（通用）

请求

GET /suno/fetch?task_id=xxxx
Authorization: Bearer YOUR_API_KEY

返回示例（简化）

{
  "status": "SUCCESS",
  "data": [
    {
      "clip_id": "a624123d-xxxx",
      "audio_url": "https://...mp3",
      "lyric": "...",
      "duration": 124
    }
  ]
}

⚠️ 后续所有操作（续写 / 分离 / mv / midi）都依赖 clip_id

---

可视化方式使用Suno（零代码）

除了API方式，神马中转API还提供了完整的可视化界面，非常适合：

• 不写代码也想体验Suno文生音乐的用户
• 产品/运营/音乐策划快速出Demo
• 用来验证Prompt、风格和效果，再迁移到API

下面以实际页面为例，演示如何通过界面生成一首歌曲。

第一步：进入Suno音乐功能

1. 打开神马上转API官网
2. 顶部菜单选择：「聊天」
3. 在聊天能力中，选择「音乐·Suno」

此时页面会切换到Suno的音乐创作界面。

第二步：选择生成模式

在左侧可以看到Suno的生成配置区：

• 描述模式：只需要描述歌曲感觉（推荐新手）
• 定制模式：可填写歌名、歌词、风格（更可控）

本示例使用的是「描述模式」。

第三步：填写歌曲信息

在输入区域中，依次填写：

• 歌曲名称：例如《城市微光》
• 歌曲描述：
  

  治愈系中文流行歌，关于夜晚和星空，情绪温暖但略带孤独

如果你只想生成带人声的完整歌曲，保持「无需歌词」即可；

如果想完全控制内容，也可以切换到定制模式，自行填写歌词。

第四步：点击「创作歌曲」

确认信息无误后，点击底部的「创作歌曲」按钮。

系统会：

1. 自动提交生成任务
2. 在右侧任务列表中显示生成进度
3. 后台调用Suno模型进行创作

⏳通常需要几十秒到1～2分钟，取决于模型和当前负载

第五步：等待生成完成并试听

当状态显示为完成后：

• 可以直接在线播放歌曲
• 查看自动生成的歌词
• 查看歌曲的风格描述（英文tags）

 

常见最佳实践

Prompt写作建议

• 风格+情绪+语言+使用场景
• 示例：
  

  中文女声，轻电子，孤独但温暖，夜晚城市

生产环境建议

• 统一封装ask轮询
• clip_id永久存储
• 区分model版本

---

你现在已经可以：

用一句话生成歌曲
精确控制歌词与风格
做续写/翻版/BGM
获取 wav / mp4 / midi / stems

Suno+API=音乐生成能力模块化