Suno · 音乐生成
Suno 音乐 API · 介绍
Suno 是功能最全的 AI 音乐能力：不仅能从一句话生成整首歌，还能延伸、翻唱、混搭、分离音轨、做音效、加封面图，甚至训练专属曲风。下面先用大白话讲清楚怎么用，再给出每个能力的入口。
怎么调用（三句话）
- 所有能力都发到同一个地址：
POST /api/cqt/generator/suno，靠task字段区分你要做什么。 - 提交后会先返回一个
taskId（任务号），音乐不是马上好。 - 拿着 taskId 去查结果：
GET /api/cqt/info/suno?id=taskId，直到状态变成 success。
关于费用
每次调用按「积分」扣费，不同能力价格不同：创作一首歌 30 积分，音效 10 积分，音轨分离 60~150 积分，小工具（歌词/标签/导出）1~4 积分。任务失败会自动退还积分，不用担心白花钱。
模型版本
创作类能力需要选 model：v55（最新，推荐）、v50、v45+、v45、v40。 不确定就用 v55。
能力地图
点击任意能力查看详细用法与在线试用：
音乐创作NEW
POST创建新音乐
从零开始生成一首全新的歌曲，你只要描述想要的风格或给一段歌词。
POST延伸歌曲
把一首已经生成的歌往后接着唱，让它更长。
POST翻唱
用新的风格重新演绎一首已有的歌（旋律保留，换风格/编曲）。
POST延伸上传的音频
把你自己上传的一段音频接着往后生成。
POST翻唱上传的音频
把你上传的音频用新风格重新演绎。
POST沿用风格配新词
保留某首歌的风格，但换上你的新歌词。
POST替换段落
只重做歌曲中的某一段（如第二段主歌），其它部分不变。
POST一键替换成曲NEW
替换段落 + 自动合并的一站式版本：一次替换生成两个候选，再各自自动合并回整曲，直接产出 2 首完整歌曲，省去手动 replace_merge。
POST加伴奏
给指定的一段音乐补上伴奏。
POST加人声
给指定的一段伴奏补上人声演唱。
POST混搭两首
把两首歌混合成一首新的。
POST采样创作
从一段已有音乐里取一小段作为灵感，生成新音乐。
POST生成音效
生成一段音效（不是歌曲），比如雷声、脚步声。
灵感播放列表NEW
增强与素材NEW
POST音质重制NEW
把一首歌的音质重新优化、提升清晰度。
POST封面图生成NEW
为你的歌曲生成一张封面图。
POST独立视频生成NEW
为音乐生成一段配套的视频画面。
POST自定义模型NEW
用你提供的音频训练一个专属的音乐风格模型。
POST声音角色NEW
从一段歌里提取一个"嗓音角色"，之后可以用它来唱别的歌。
POST声音角色①·建会话NEW
声音角色第 1 步（免费）：上传你的原声 + 指定语言，返回一句"验证短语"和会话 taskId。
POST声音角色②·创建角色NEW
声音角色第 2 步（5 积分）：传 init 返回的 taskId + 朗读验证短语的录音 URL + 角色名，创建声音角色。
POST合并两首歌词NEW
把两段歌词文本合并生成一份新歌词，常作为 mashup（混搭）的前置步骤。传的是歌词文本，不是 clipId。
音频编辑NEW
常见错误
| 错误码 | msg | 含义 | 处理建议 |
|---|---|---|---|
| 451 | artist name not allowed | 描述中包含了具体艺人名（Suno 不允许引用特定艺人）。提示原文：Your description contains artist name ... - we don’t reference specific artists on Suno. | 去掉描述中的艺人名，改用风格/曲风词（如 pop、jazz、upbeat）后重试 |
| 451 | content moderation | 提示词/歌词不合规（命中内容审核） | 修改提示词或歌词后重试 |
| 401 | Unauthorized | APIKey 无效或已禁用 | 检查 Authorization 头与 APIKey 是否正确 |
| 402 | insufficient credits | 积分不足 | 前往控制台充值后重试 |
| 429 | Task limit reached | 运行中的任务数超过并发上限 | 等待已有任务完成后再提交 |
| 500 | failed / timeout | 任务失败或请求超时 | 稍后重试；持续失败请联系支持 |
提示：右上角 Authorize 保存你的 APIKey 后，每个能力页都能直接「在线运行」。