创建音乐

音乐模型 ID，例如 suno-music。仅生成歌词时，请选择当前公开操作包含 lyrics 的模型。

音乐描述或替换文本。音乐、歌词、upload-cover、upload-extend 和 replace-section 请求必填；add-instrumental 和分轨请求可省略。

生成歌曲的标题。

风格标签（例如 "pop, upbeat, electronic"）。

需要避开的风格。audio_operation 为 add-instrumental 时必填。

可选值为 MUSIC 或 LYRICS。请选择支持对应公开操作的模型；此字段不会让仅支持音乐的模型具备歌词能力。

Suno 版本选择器。生成、upload-cover、upload-extend、add-instrumental 以及以 audio_url 为源的替换请求必填。歌词、以 task_id + audio_id 为源的替换和分轨请求请省略。支持值： chirp-v3-5, chirp-v4, chirp-v4-5, chirp-v4.5, chirp-v4-5plus, chirp-v4.5plus, chirp-v4-5all, chirp-v4.5all, chirp-v5, chirp-v5-5, chirp-v5.5.

设为 true 时生成无歌声的纯音乐。

可以从互联网访问的参考音频 URL。填写这个字段但省略 audio_operation 时，默认使用 upload-cover。

音频操作： upload-cover, upload-extend, add-instrumental, replace-section, vocal-separate, multi-stem-separation, advanced-split.

vocal-separate、multi-stem-separation 和 advanced-split 需要 task_id + audio_id；advanced-split 还需要 stem_name。upload-extend 需要大于 0 的 continue_at。add-instrumental 需要 audio_url、title、tags 和 negative_tags。

replace-section 必须提供 prompt、tags、title、infill_start_s、infill_end_s 和 full_lyrics。来源只能二选一：task_id + audio_id，或 audio_url + mv。替换区间必须为 6–60 秒。

本组织拥有的源任务 ID，用于生成音频的分段替换或分轨。

源任务结果返回的音频 ID。替换已生成音频和分轨时，需要与 task_id 一起提供。

替换区间的起始秒数，必须大于等于 0。replace-section 必填。

替换区间的结束秒数。replace-section 必填，必须比 infill_start_s 晚 6–60 秒。

结果歌曲的完整歌词。replace-section 必填。

分轨名称。advanced-split 必填。

要续写的上一个片段的 ID。

续写起点，单位为秒。upload-extend 必填且必须大于 0。

用于查询状态的任务 ID。

同一个异步任务 ID 的别名，仅在返回时存在。

创建响应提供时，优先使用的轮询 URL。

任务状态：pending、processing、completed 或 failed。

任务创建的 Unix 时间戳，仅在返回时存在。