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。
能力地图
点击任意能力查看详细用法与在线试用：
音乐创作
POST创建新音乐
从零开始生成一首全新的歌曲，你只要描述想要的风格或给一段歌词。
POST延伸歌曲
把一首已经生成的歌往后接着唱，让它更长。
POST翻唱
用新的风格重新演绎一首已有的歌（旋律保留，换风格/编曲）。
POST延伸上传的音频
把你自己上传的一段音频接着往后生成。
POST翻唱上传的音频
把你上传的音频用新风格重新演绎。
POST沿用风格配新词
保留某首歌的风格，但换上你的新歌词。
POST替换段落
只重做歌曲中的某一段（如第二段主歌），其它部分不变。
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 后，每个能力页都能直接「在线运行」。