返回模型调用 API 参考POST/suno/submit/music
续写歌曲与使用限制
SunoAPI 项目通过 music 请求的续写字段延续原歌曲。当前插件能转发这些字段,但不提供独立 extend action 或原任务渠道绑定。
先确认适用条件
原歌曲必须已生成成功,且当前被选择的上游能够访问它。插件没有声明原任务关联逻辑,不会保证本次请求与原任务选择同一上游,也不会把请求体里的 task_id 换成上游私有 ID。多个上游之间的歌曲通常不能直接互用。
已核对的 SunoAPI 开源实现只检查续写的 task_id 非空;实际使用的上游若额外校验原任务 ID,可能拒绝中转站的公共 ID。遇到这种情况,请先确认该上游的续写兼容性,不要自行猜测或索取私有 ID。
入口与鉴权
POST https://top.qingyuntop.ai/suno/submit/music
请求头为 Authorization: Bearer YOUR_API_KEY、Content-Type: application/json。不要改为 /suno/submit/extend,插件只接受 MUSIC 和 LYRICS 两个 action。
续写参数
task_id:原 music 创建返回的任务 ID;上述兼容性限制适用。continue_clip_id:原任务成功结果中选定歌曲的 id,不是 task_id,也不是音频 URL。continue_at:从原歌曲第几秒开始续写,可使用小数,应位于有效时长内。示例 60 仅适用于原歌曲长于 60 秒。prompt、title、tags:续写歌词和风格;mv 应使用上游确认可用于原歌曲的版本。
省略 gpt_description_prompt,否则上游会进入灵感分支而不发送续写素材。
Request
请求
/suno/submit/musicBody
必填路径、查询与 Header 参数
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|
Content-Type | Header | string | 是 | - | application/json |
Accept | Header | string | 是 | - | application/json |
Authorization | Header | string | 是 | 必填。使用青云TOP API 的 API Key,保留 Bearer 后的空格。 | Bearer YOUR_API_KEY |