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 返回值为当前事实依据。