在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/sunoGoAmz v1/suno/v1GoAmz v3.5/suno/v1/mv-3.5SUNO 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-5mvinspiration=灵感模式场景二：自定义模式（歌词+歌名）
最常用、可控性最高
示例需求
歌名：《城市微光》
歌词：自定义
风格：中文流行+电子
请求示例
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音乐功能
打开神马上转API官网
顶部菜单选择：「聊天」
在聊天能力中，选择「音乐·Suno」
此时页面会切换到Suno的音乐创作界面。
第二步：选择生成模式
在左侧可以看到Suno的生成配置区：
描述模式：只需要描述歌曲感觉（推荐新手）
定制模式：可填写歌名、歌词、风格（更可控）
本示例使用的是「描述模式」。
第三步：填写歌曲信息
在输入区域中，依次填写：
歌曲名称：例如《城市微光》
歌曲描述：
治愈系中文流行歌，关于夜晚和星空，情绪温暖但略带孤独
如果你只想生成带人声的完整歌曲，保持「无需歌词」即可；
如果想完全控制内容，也可以切换到定制模式，自行填写歌词。
第四步：点击「创作歌曲」
确认信息无误后，点击底部的「创作歌曲」按钮。
系统会：
自动提交生成任务
在右侧任务列表中显示生成进度
后台调用Suno模型进行创作
⏳通常需要几十秒到1～2分钟，取决于模型和当前负载
第五步：等待生成完成并试听
当状态显示为完成后：
可以直接在线播放歌曲
查看自动生成的歌词
查看歌曲的风格描述（英文tags）
常见最佳实践
Prompt写作建议
风格+情绪+语言+使用场景
示例：
中文女声，轻电子，孤独但温暖，夜晚城市
生产环境建议
统一封装ask轮询
clip_id永久存储
区分model版本
你现在已经可以：
用一句话生成歌曲
精确控制歌词与风格
做续写/翻版/BGM
获取 wav / mp4 / midi / stems
Suno+API=音乐生成能力模块化
