创建 - MountSea API

新歌。不要传 create_mode 或 agentic_thinking。模式由字段推断。

模式	何时
Custom	`prompt` 非空（你写歌词）
Simple	不传 `prompt`（或 `""`），不传 `persona`，并且 `gpt_description_prompt` / `audio_refs` / `attached_styles` / `image_urls` 至少有一个
仍是 Custom	`prompt` 为空，上面四个也都没有

口播是同一个任务。见语音。 POST /suno/v2/generate 返回 { "taskId" }。轮询查询任务状态。Schema：GET /suno/v2/generate/schema?task=create。

参数

字段	必填	说明
`task`	是	`"create"`
`model`	是	`chirp-v6`、`chirp-v6-mini`、`chirp-v6-wild`，或 `chirp-custom:<uuid>`。旧名字转到 v6 Pro
`prompt`	Custom	歌词。非空 → Custom。和 `audio_refs` 或 `image_urls` 一起传会 400
`gpt_description_prompt`	Simple	官方想法框。`prompt` 有歌词时忽略。只传参考、`attached_styles` 或 `image_urls` 时可以是 `""`
`audio_refs`	否	仅 Simple。1–4 条。有 `clip_id` 即可。和 `prompt` 或 `persona` 一起 → 400。别人的片段可能是 remix
`attached_styles`	否	Simple 的风格段落。可单独用，也可和参考曲 / 图片一起。Custom 下忽略
`image_urls`	否	仅 Simple。1–5 个 jpeg 或 png 地址。见图片
`persona`	否	有它就保持 Custom。和 `image_urls` 一起 → 400。Voice Persona：`is_voice: true` 时只需要 `persona_id`
`is_speech` / `backing_music`	否	仅语音。见语音

audio_refs[]：clip_id 必填；style_prompt、lyrics、duration_s 可选。按模型选取，片段不必属于账号池。

图片

image_urls 是官网 Simple 的 + Image。只用于 task=create、prompt 为空、且没有 persona。只传图片也能进入 Simple，不必再写 gpt_description_prompt。同一个请求里仍然可以带想法、audio_refs 或 attached_styles。服务端会下载每个地址，用这次生成选中的账号上传，再把得到的 id 发给上游。调用方只传 URL。不传这个字段就保持原请求。不要传空数组。

规则	说明
数量	1–5。每个值都要带 `http` 或 `https`
类型	JPEG 或 PNG，按文件内容判断
大小	每张最多 20MB
和歌词或 `persona` 一起	HTTP 400
`create` 以外的任务	HTTP 400
下载失败、类型不对、超过 20MB，或审核未通过	HTTP 451

示例

Custom — 自己写词：

{
  "task": "create",
  "model": "chirp-v6",
  "title": "Summer Vibes",
  "tags": "Pop, Happy, Upbeat",
  "prompt": "[Verse]\nSunshine on my face today\nDriving down the coast away\n\n[Chorus]\nSummer vibes, feeling free\nThis is where I want to be",
  "make_instrumental": false
}

Simple — 只给想法。不传 prompt，不传 persona：

{
  "task": "create",
  "model": "chirp-v6",
  "gpt_description_prompt": "Emotive bossa nova song about the silence after a fight"
}

Simple — 想法加上最多四首参考。只传 clip_id 即可：

{
  "task": "create",
  "model": "chirp-v6",
  "gpt_description_prompt": "Rework this as progressive rock",
  "audio_refs": [{ "clip_id": "3e7e9538-c474-45a7-8181-3da327bd654b" }]
}

Simple — 想法加上图片。不传 prompt，不传 persona：

{
  "task": "create",
  "model": "chirp-v6",
  "gpt_description_prompt": "Score this as neo-soul",
  "image_urls": ["https://example.com/cover.jpg"]
}

其他可选字段：共用列表。

​参数

​图片

​示例

参数

图片

示例