先确认适用条件

原歌曲必须已生成成功,且当前被选择的上游能够访问它。插件没有声明原任务关联逻辑,不会保证本次请求与原任务选择同一上游,也不会把请求体里的 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,否则上游会进入灵感分支而不发送续写素材。