Suno API 教程：从申请 Key 到拿到第一首歌
接入本身只有四步，卡人的地方是两件常被忽略的事：任务其实是异步的，以及取文件不算一次生成。
第一步：拿到 Key
官方没有对外发放 API Key；对客的 Key 来自第三方平台。注册后在自己的控制台创建一个令牌，调用时放在请求头里：
Authorization: Bearer YOUR_API_KEY
Content-Type: application/jsonKey 只放服务端，不要写进前端代码、App 安装包或公开仓库。
第二步：提交生成
灵感模式只要一段描述，专业模式可以指定歌词与风格：
POST /api/music/create
{
"description": "明亮的中文流行，钢琴前奏，温暖女声",
"model": "suno-v6"
}第三步：轮询状态
提交成功不等于生成完成。拿到歌曲 ID 后按 3-5 秒一次的节奏查询，直到状态变成完成。别把轮询做成高频请求，也别在超时后盲目重提——那是最常见的重复扣费原因。
第四步：取音频与文件
完成后先取媒体地址（可指定 MP3 / WAV / 视频 / 封面 / MIDI），需要落盘再调下载接口。读取类接口免费，只有生成与编辑动作计费。
常用接口速查
| 要做什么 | 接口 | 是否收费 |
|---|---|---|
| 提交生成 | POST /api/music/create（专业模式 /create/custom） | 收费，一次 0.6 元出 2 首 |
| 查询状态 / 列表 / 参数 | POST /api/music/query、GET /api/music/songs | 免费 |
| 取媒体地址 / 下载 | POST /api/music/download-url、/download-file | 免费 |
| 歌词与时间轴 | POST /api/lyrics/generate、/api/lyrics/timeline | 免费额度内免费 |
| 翻唱 / 续写 / 分轨 | /api/music/upload-cover、/extend、/separate | 收费 |
常见问题 / FAQ
Suno API 有官方的吗？
没有对外发放的官方 API Key。可用的都是第三方平台封装的接口，选择时重点看账号来源、计费口径与失败退费。
接口调用要不要自己有 Suno 账号？
不需要。账号和登录态由平台维护，你只需要平台发的 API Key。
一次调用出几首歌？
生成类默认一次返回 2 首；编辑类（替换段落、分轨等）通常返回 1 个结果。
申请 Key、第一个请求、接口清单与报错排查
注册只需要邮箱，一次生成 0.6 元出 2 首，MP3 与 WAV 下载不限次。
看完整接入文档
注册只需要邮箱，一次生成 0.6 元出 2 首，MP3 与 WAV 下载不限次。