Create 选项

官网 suno.com Create 对应 /suno/v2/generate。下面滑条 / Max Mode 字段都可选 — 不传则行为 / 计费与以前一致。 task=create 本身有两种模式（Custom vs Simple）。见生成音乐。不要传 agentic_thinking 或 create_mode。

Custom vs Simple（`task=create`）

官网 Create	怎么进
Custom（自己写词）	`prompt` 非空
Simple（想法框）	不传 `prompt`（或 `""`），不传 `persona`，且至少有一个：`gpt_description_prompt` / `audio_refs` / `attached_styles` / `attached_lyrics` / `image_urls` / `video_url`

空 prompt 且六个字段都没有，仍是 Custom。

官网 Simple UI	API
想法文本框	`gpt_description_prompt`
挂已有歌曲（1–4）	`audio_refs` — 必填 `clip_id`；ByModel（不必同账号）
附加风格段落	`attached_styles`
钉住歌词（仍是 Simple）	`attached_lyrics` — `prompt` 保持为空；`prompt` 非空时忽略该字段
图片（1–5）	`image_urls`
一条参考视频	`video_url` — 一个 mp4 地址

audio_refs 和 prompt / persona 一起传会 HTTP 400。其他人的 clip 可能被标 remix / 不能商业下载。

配合生成音乐使用。各任务字段见 Generate Schema。

官网 UI → API

官网 Create	API 字段	说明
Max Mode	`max_mode`	`true` = 更多算力、全曲更稳。官方账号积分 2 倍；平台在 `max_mode=true` 时按规则 2 倍计费。不传 / `false` = 现价。支持 `create` / `extend` / `cover` / `mashup` / `add_stems` 等生成类任务；*`gen_stem_` 和 `sound` 传 `true` 会 HTTP 400**
Personalize / My Taste	`use_personalization`	使用所选官方账号的口味画像。不保证生效（池账号可能没有口味数据）。不传 / `false`
Vocal Gender	`vocal_gender`	`m` / `f`。不传 = 不指定
Exclude styles	`negative_tags`	字符串或字符串数组
Style Influence	`controls.style_weight`	0~1
Weirdness	`controls.weirdness_constraint`	0~1；越高越实验
Variety	`controls.aug_creativity`	整数 0~4。`2` = Normal（官网默认），`4` = 滑条拉满。不传 = 官方默认
Duration Custom	`controls.duration`	秒 10~360。Auto = 不传。chirp-v55 / chirp-v6+；旧模型 / `chirp-custom:*` 忽略
Audio influence（翻唱 / 延长）	`controls.audio_weight`	0~1

max_mode: true 会按平台规则把用户计费翻倍。不要随手打开。

示例

curl -X POST https://api.mountsea.ai/suno/v2/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "task": "create",
    "model": "chirp-v6",
    "prompt": "[Verse]\nHello world...",
    "tags": "Pop, Happy",
    "negative_tags": "Sad, Slow",
    "vocal_gender": "f",
    "max_mode": false,
    "use_personalization": false,
    "controls": {
      "style_weight": 0.29,
      "weirdness_constraint": 0.37,
      "aug_creativity": 2,
      "duration": 110
    }
  }'