本站使用 Suno 官方 V6 模型，提供 API Key。接入流程本身不复杂，关键是要理解它是异步任务：提交成功不等于生成完成，必须再查询一次状态。下面按顺序走一遍。
第一步：拿到 API Key
注册账号后，在控制台获取 API Key。调用时放在请求头里：
Authorization: Bearer <API_KEY>
Content-Type: application/jsonAPI Key 只放在你自己的服务端，不要写进前端代码、移动端安装包或公开仓库。
第二步：提交生成请求
灵感模式只需要一段描述：
POST /api/music/create
{
"description": "明亮的中文流行歌曲，钢琴前奏，温暖女声",
"model": "suno-v6"
}专业模式可以指定歌词、风格和标题：
POST /api/music/create/custom
{
"lyrics": "[Verse]\n夜色落在窗前",
"style_tags": "mandopop, piano, warm",
"song_title": "向光而行",
"model": "suno-v6"
}第三步：轮询任务状态
提交后会拿到歌曲 ID。用查询接口确认状态，建议每 3 到 5 秒查一次，不要高频重试。
POST /api/music/query
{ "song_ids": ["你的歌曲 ID"] }| 状态 | 含义 |
|---|---|
| pending / processing | 已受理或正在生成，继续等待 |
| completed | 已完成，可以获取音频地址 |
| failed | 终态失败，读取错误信息 |
第四步：获取音频地址
任务完成后调用下载地址接口，按需要取 MP3、WAV 或视频：
POST /api/music/download-url
{ "song_id": "你的歌曲 ID", "kind": "mp3" }请使用接口返回的地址，不要自行拼接或缓存历史链接。
余额怎么查？哪些接口不收费
余额挂在账号上，不在 API Key 上，查询接口免费：
GET /api/user/balance
Authorization: Bearer <API_KEY>返回字段与示例见账户余额查询 API。计费口径分两类，先分清再估算成本：
| 类型 | 举例 | 是否扣费 |
|---|---|---|
| 生成与编辑类 | 灵感模式、专业模式、翻唱、续写、替换段落、分轨 | 按次计费，生成默认 0.6 元一次出 2 首；任务失败自动退费 |
| 查询与读取类 | 歌曲查询、歌曲列表、余额查询、时间轴歌词、媒体下载（MP3 / WAV / 视频 / 封面 / MIDI）、分轨删除 | 免费 |
想先算一笔账，可以对照Suno API 计费说明里的单价表。
几个容易踩的坑
- 把提交成功当成生成完成，直接去读音频地址，结果拿到空值。
- 用页面上的临时占位 ID 去调用接口，应该使用真实的歌曲 ID。
- 忘记处理失败终态，任务卡在轮询里。
- 在客户端暴露 API Key。
完整字段与接口清单见 API 总览，需要联调协助可以联系客服。
相关指南：移动 App 背景音乐 API 接入方案 · Suno API 端点地图 · 401、403、429 错误排查
