suno api 说明
Suno API 接口使用文档
📑 目录
📋 接口总览
https://api.tu-zi.com🎵 核心接口
1. 音乐生成接口
/suno/generate (POST)场景 1️⃣ - 灵感模式
gpt_description_prompt{
"gpt_description_prompt": "赛博朋克城市的午夜漫游"
}{
"clips": [
{
"id": "abc123-def456",
"status": "submitted",
"title": "霓虹梦境",
"tags": "synthwave, cyberpunk, electronic"
}
]
}场景 2️⃣ - 自定义模式
prompt, mv, title, tags[Verse] - 主歌[Chorus] - 副歌[Bridge] - 桥段[Intro] - 前奏[Outro] - 尾奏{
"prompt": "[Verse]\n银河系边缘的流浪者\n星尘是我的指引\n\n[Chorus]\n穿越时空寻找你\n在平行宇宙的尽头",
"mv": "chirp-v3-5",
"title": "星际旅人",
"tags": "space rock, dreamy, atmospheric"
}场景 3️⃣ - 纯音乐自定义
prompt="", tags, mv, title{
"prompt": "",
"tags": "lo-fi hip hop, chill beats, jazz piano",
"mv": "chirp-v3-5",
"title": "深夜咖啡馆"
}场景 4️⃣ - 纯音乐灵感
gpt_description_prompt, make_instrumental: true{
"gpt_description_prompt": "海底冒险的史诗配乐，神秘而壮丽",
"mv": "chirp-v3-5",
"prompt": "",
"make_instrumental": true
}场景 5️⃣ - 续写音频
continue_clip_id, continue_atmv (chirp-v4/chirp-auk/chirp-bluejay)task: "upload_extend"{
"continue_clip_id": "ca94a97d-d3f2-4a63-aeee-ba3a43384bcd",
"continue_at": 10,
"mv": "chirp-v4",
"task": "upload_extend",
"prompt": "歌词",
"tags": "",
"title": "标题"
}mv 和 task{
"continue_clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
"continue_at": 57,
"prompt": "",
"tags": "",
"title": ""
}场景 6️⃣ - 混音重制
reference_clip_idmv (chirp-v4/chirp-auk/chirp-bluejay)task: "upload_reference"{
"reference_clip_id": "ca94a97d-d3f2-4a63-aeee-ba3a43384bcd",
"mv": "chirp-v4",
"task": "upload_reference",
"prompt": "描述或歌词",
"tags": "",
"title": "标题"
}mv 和 task{
"reference_clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
"prompt": "",
"tags": "",
"title": ""
}场景 7️⃣ - 替换片段
infill_clip_id, infill_start_s, infill_end_smv (chirp-v4/chirp-auk/chirp-bluejay)task: "upload_infill"{
"infill_clip_id": "ca94a97d-d3f2-4a63-aeee-ba3a43384bcd",
"infill_start_s": 10,
"infill_end_s": 20,
"mv": "chirp-v4",
"task": "upload_infill",
"prompt": "替换后的歌词",
"tags": "",
"title": "标题"
}mv 和 task{
"infill_clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
"infill_start_s": 0,
"infill_end_s": 10,
"prompt": "",
"tags": "",
"title": ""
}场景 8️⃣ - 全轨分离
clip_id, task: "all-stems"{
"clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
"task": "all-stems"
}场景 9️⃣ - 人声分离
clip_id, task: "vocal-stems"{
"clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
"task": "vocal-stems"
}场景 🔟 - 改写
clip_id, task: "rewrite"{
"clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
"task": "rewrite"
}场景 1️⃣1️⃣ - 重新填词
overpainting_clip_id, overpainting_start_s, overpainting_end_s, task: "overpainting"chirp-bluejay 模型{
"mv": "chirp-bluejay",
"overpainting_clip_id": "9b1d2e8d-a365-4bfd-8a18-8989e159b29f",
"overpainting_start_s": 0,
"overpainting_end_s": 57.9,
"task": "overpainting",
"prompt": "新的歌词内容",
"tags": "A smooth, soulful R&B track with a moderate tempo",
"title": "新标题",
"override_fields": ["prompt", "tags"]
}2. 查询结果接口
/suno/feed/{clipsIds} (GET)/suno/feed/clip_id/suno/feed/clip_id1,clip_id2,clip_id3submitted: 已提交queued: 排队中streaming: 生成中complete: 完成error: 错误3. 音频上传接口
/suno/upload (POST)multipart/form-datafile (音频文件)clip_id: 音频的唯一标识duration: 音频时长（秒）clip_id 可用于：continue_clip_id)reference_clip_id)infill_clip_id)4. MIDI 获取接口
/suno/act/midi/{clip_id} (GET)1.
clip_id2.
clip_id 调用此接口3.
state: "running"，需要轮询等待4.
state: "complete" 时，获得完整MIDI数据state: "running" - 处理中，需要轮询state: "complete" - 完成，包含完整MIDI数据clip_idclip_id 也能执行，但可能没有数据clip_id5. Style Tags 扩展接口
/suno/act/tags (POST)original_tags{
"original_tags": "魔法森林"
}{
"upsampled_tags": "Mystical orchestral fantasy with ethereal choir, enchanted woodwinds, and shimmering strings. Celtic harp and gentle percussion create a magical woodland atmosphere.",
"request_id": "507acd16-8b84-4e55-be2b-4329d82efb26"
}upsampled_tags 可直接用于生成音乐时的 tags 参数📊 接口分类
🎼 音乐创作类（4个场景）
🔄 音频操作类（3个场景）
🎚️ 音频处理类（4个场景）
🛠️ 辅助工具类（4个接口）
🔄 典型工作流程
流程 1: 快速创作
1.
2.
3.
流程 2: 精细创作
1.
2.
3.
流程 3: 上传音频续写
1.
clip_id2.
clip_id 续写3.
流程 4: 提取伴奏
1.
2.
3.
流程 5: 获取MIDI
1.
2.
3.
流程 6: 混音创作
1.
reference_clip_id2.
3.
流程 7: 修改歌词保持旋律
1.
clip_id2.
3.
🎯 快速查找指南
我想生成一首新歌
我想修改已有音乐
我想处理音频
我不知道怎么写风格标签
📝 模型版本
| 版本名称 | 发布日期 | 说明 | 可用场景 |
|---|---|---|---|
| chirp-crow | 2025.09.23+ | v5 版本 | 场景1-11 |
| chirp-bluejay | 2025.07.17+ | v4.5+ 版本 | 场景1-11，场景11必须 |
| chirp-auk | 2025.05.03+ | v4.5 版本 | 场景1-11 |
| chirp-v4 | - | v4 版本 | 场景1-11 |
| chirp-v3-5 | - | v3.5 版本 | 场景1-11 |
最佳实践
📖 认证方式
📋 接口路径总结
物理路径统计
| 序号 | HTTP 方法 | 路径 | 场景数 | 主要功能 |
|---|---|---|---|---|
| 1 | POST | /suno/generate | 11 | 音乐生成（多场景） |
| 2 | GET | /suno/feed/{clipsIds} | 1 | 查询结果 |
| 3 | POST | /suno/upload | 1 | 上传音频 |
| 4 | GET | /suno/act/midi/{clip_id} | 1 | 获取MIDI |
| 5 | POST | /suno/act/tags | 1 | 扩展风格标签 |
🌟 文档特点
✅ OpenAPI 文档优势
1.
2.
3.
4.
5.
📱 文档使用建议
💡 创意示例集
🎮 游戏音效场景
{
"gpt_description_prompt": "8bit复古游戏的boss战斗音乐",
"mv": "chirp-v3-5",
"make_instrumental": true
}🎬 电影配乐场景
{
"prompt": "[Intro]\n神秘的序章开启\n\n[Verse]\n古老的预言在风中低语",
"tags": "cinematic orchestral, epic, dramatic",
"title": "失落的王国",
"mv": "chirp-v4"
}🧘 冥想放松场景
{
"prompt": "",
"tags": "ambient, meditation, nature sounds, healing",
"title": "晨曦森林",
"mv": "chirp-v3-5"
}🎸 摇滚嗨歌场景
{
"prompt": "[Chorus]\n打破常规释放自我\n让世界听见我的声音",
"tags": "alternative rock, energetic, rebellious",
"title": "逆流而上",
"mv": "chirp-auk"
}📚 附录
常用音乐风格标签
| 类型 | 推荐标签 |
|---|---|
| 电子音乐 | synthwave, EDM, techno, house, dubstep |
| 摇滚乐 | rock, punk, metal, indie rock, grunge |
| 流行音乐 | pop, K-pop, synth-pop, dream pop |
| 嘻哈说唱 | hip hop, trap, lo-fi hip hop, boom bap |
| 古典音乐 | classical, orchestral, piano, baroque |
| 爵士乐 | jazz, smooth jazz, bebop, fusion |
| 氛围音乐 | ambient, chillout, downtempo, atmospheric |
歌词结构参考
完整歌曲结构示例：
[Intro] - 前奏 (0-8秒)
[Verse 1] - 主歌1 (8-24秒)
[Pre-Chorus] - 预副歌 (24-32秒)
[Chorus] - 副歌 (32-48秒)
[Verse 2] - 主歌2 (48-64秒)
[Chorus] - 副歌重复 (64-80秒)
[Bridge] - 桥段 (80-96秒)
[Chorus] - 副歌终章 (96-112秒)
[Outro] - 尾奏 (112-120秒)修改于 2025-11-13 07:52:25