Skip to main content

Suno

Suno V6 是 Suno 的音乐模型。在 Wizzx 上它使用 suno model key,并以音乐动作的形式提供:POST /api/v1/music/{action} 可以创作歌曲与音效、基于已有曲目继续创作、编辑曲目,以及分析或导出曲目。每个动作都是一个异步任务,通过 POST /api/v1/task/status 查询,每次调用计费一次。 POST /api/v1/task/submit/suno 仍然可用,等同于 generate 动作。 每个动作的字段、模式规则与错误码见 提交音乐动作。

能做什么

生成歌曲

generate 通过 custom 选择模式:
  • 灵感模式(custom: false,默认):prompt 为歌曲描述,最多 3,000 个字符。
  • 自定义模式(custom: true):prompt 填写歌词(最多 5,000 个字符),可选 title、style、negative_tags、auto_lyrics、persona_task_id、max_mode 与 duration。
文本长度按 Unicode 字符计算。传入动作不接受的字段(包括在灵感模式下传入仅限自定义模式的字段)会返回 HTTP 422。 灵感模式:
自定义模式:
提交到 POST /api/v1/music/generate(或等价的 POST /api/v1/task/submit/suno)。保存响应中的 data.task_id,再通过 /api/v1/task/status 查询。生成通常需要 30–120 秒。

结果

任务成功后,result_urls 列出所有生成曲目的 URL,result.tracks 返回每首曲目的详细信息:
不要假定一定是两首,请遍历 result.tracks 或 result_urls。其他动作会在 result 中返回歌词、BPM、MIDI、文件、视频或 ID,详见 任务状态中的音乐结果。

基于曲目继续创作

用曲目所在任务的 task_id,并把曲目的 index 作为 audio_index,即可引用已完成的曲目。例如用 POST /api/v1/music/extend 从 1:30 处续写第 2 首:
之后用 concat 把续写拼接为完整歌曲。只能引用你自己的、状态为 SUCCEEDED 的 Suno 任务。add-vocals、add-instrumental 与 sample 需要 upload 任务作为来源,concat 需要 extend 任务。详见 提交音乐动作 中的「引用已有任务」。

计费

每次调用对整个任务计费一次,与返回多少首曲目无关。version 与 duration 不影响价格。
在有模式开关的动作上,max_mode 需要自定义模式。失败的任务会退回积分。仍应以 /pricing 返回值为当前事实依据。
机器可读 Schema 请查看 提交音乐动作;旧入口见 提交 Suno 任务。

来源