创建音乐
接口: POST https://quanzil.com/suno/submit/music
等价于 POST /suno/submit/{action} 且 action=music(路由参数见 manifest)。
支持模型(mv):用户侧可复制 ID(与下方 examples 对齐;chirp-auk / chirp-fenix 仅为别名):
- chirp-v3-0(对应版本 v3.0)
- chirp-v3-5(对应版本 v3.5)
- chirp-v4(对应版本 v4.0)
- chirp-v4-5(对应版本 v4.5;别名 chirp-auk)
- chirp-v5(对应版本 v5.0)
- chirp-v5-5(对应版本 v5.5;别名 chirp-fenix)
- chirp-v6(对应版本 v6.0)
- chirp-v6-wild(对应版本 v6-wild)
- chirp-v6-mini(对应版本 v6-mini)
- acemusic-v1.1(ACE Music v1.1 Preview,推荐)
- acemusic-v1(ACE Music v1)
- ace-step-1.5-xl(ACE-Step v1.5 XL)
ACE 版本:mv 填 ACE 版本号即切到 ACE 音乐模型(网关自动带上游 expectAiModel=ace,无需额外参数),其余参数与 Suno 相同,价格与 Suno 相同。
ACE 支持灵感模式、自定义模式、翻唱;翻唱流行歌曲 / 已在 Suno 库里的歌不会被 Suno 版权拦截。
翻唱:cover_clip_id 直接填音频 URL(推荐),或填先用 POST /suno/uploads/audio(带 expect_ai_model: ace)上传参考音频后得到的 so_ 开头 ID。
自定义模式可选 negative_tags(不想要的风格)。MIDI 创作是 Suno 专属,不能和 ACE 版本一起用(会返回 400)。
字段优先级:若同时提供 gpt_description_prompt 与 prompt,以网关/上游实际分支为准(勿当作简单二选一可同时填)。详见 API-Doc-Standards §2.3。
clip 续写:continue_clip_id 须来自先前 fetch 返回的 clip/song,不可自造。
接入步骤
A. 生成音乐
可以通过场生成歌曲接口生成后,获取其中的一首歌的 clip_id 值为: 54834687-5e79-4f08-8e14-cf188f15b598
B. 新建 Persona
clip_id需要系统内存在的,非 uploader- 不能跨账号,所以可能账号下线用不了
C. 使用 persona_id 创作
注意事项:
- mv 为
chirp-v3-5-tau或者chirp-v4-tau - task 为
artist_consistency - persona_id 为 B 步骤得到的
- artist_clip_id 就是 A 步骤中的
clip_id - 可跨账号
提交 AI 音乐创作任务,支持三种模式:
- 描述模式:填写
gpt_description_prompt,AI 自动生成音乐风格与歌词 - 自定义模式:填写
prompt(歌词)+tags(风格标签),精确控制创作方向 - 纯音乐模式:设置
make_instrumental: true,生成无歌词背景音乐 - 续写模式:填写
continue_clip_id+continue_at,延续已有片段 - MIDI 创作:灵感模式 +
metadata_params.midi_id(MIDI 文件网址),按 MIDI 旋律创作
本接口在模型广场和消费记录中显示为 suno_music_open。
MIDI 创作(Open 渠道)
上传一段 MIDI 旋律,AI 按旋律创作歌曲:MIDI 决定弹什么音,gpt_description_prompt 决定风格、乐器和演奏方式(如「改编成弦乐四重奏,严格按 MIDI 的音符与和弦演奏」)。
-
metadata_params.midi_id填 可公开访问的.mid/.midi文件网址(http/https),由上游下载;API 不提供文件上传,请自行托管文件。值为null或空字符串时视为未传。 -
只支持灵感模式:必须填
gpt_description_prompt;不能同时带prompt(歌词)、task、continue_clip_id、cover_clip_id,否则返回 400。 -
模型固定为
chirp-v6-wild(Suno 官方限制):mv不传或传其它版本都会被网关改为chirp-v6-wild。 -
计费与普通创作相同;查询结果方式不变(
POST /suno/fetch)。
请求体 (application/json)
gpt_description_prompt(string, 必填): 创作描述 / 灵感提示词make_instrumental(boolean, 必填): 是否纯音乐mv(string, 必填) ["chirp-v5-5", "chirp-v5", "chirp-v4-5+", "chirp-v4-5", "chirp-v4-5-all", "chirp-v4", "chirp-v3-5", "chirp-v6", "chirp-v6-wild", "chirp-v6-mini", "acemusic-v1.1", "acemusic-v1", "ace-step-1.5-xl"]cover_clip_id(string): 翻唱的源音频。ACE 版本可直接填音频 URL,或填 POST /suno/uploads/audio(带 expect_ai_model=ace)上传后得到的 so_ 开头 IDexpect_ai_model(string): 指定上游模型,只接受 ace。通常不用填:mv 填 ACE 版本时网关自动带上 ["ace"]metadata_params(object): 扩展参数;MIDI 创作时填 midi_idnegative_tags(string): 自定义模式下不想要的风格标签(可选,ACE 版本支持)
请求示例
{
"gpt_description_prompt": "一首轻快的夏日流行歌",
"make_instrumental": false,
"mv": "acemusic-v1.1"
}