音效 - MountSea API

Sounds 页。始终是纯器乐。sound.description 同时是官方 tags 和标题（标题大小写，80 字处截断并加 ...）。你传的 prompt 或 tags 都会被覆盖。max_mode 会 HTTP 400。 POST /suno/v2/generate 返回 { "taskId" }。轮询查询任务状态。Schema：GET /suno/v2/generate/schema?task=sound。

参数

字段	必填	说明
`task`	是	`"sound"`
`model`	是	`chirp-v6`
`sound.description`	是	这是什么声音。原样作为上游 tags
`sound.type`	否	`"one_shot"`（默认）或 `"loop"`。只有 `loop` 会设置 `sound_configs.user_loop`
`sound.key`	否	不传 = Any。见下表。非法调性 → 400
`sound.bpm`	否	1–300 → `user_tempo`。不传 = Auto

不要传 max_mode。

调性

不传 sound.key 就是 Any（不发 user_key）。不在下表里的值会 HTTP 400。 maj / min 前面必须有空格："G maj"，不能写成 "Gmaj" 或 "G major"。自然音原样发送。大调去掉 maj。小调把 min 换成 m。"G" 和 "G maj" 都变成 "G"。"A min" 变成 "Am"。

音名	自然音	大调	小调
C	`C` → `C`	`C maj` → `C`	`C min` → `Cm`
C#	`C#` → `C#`	`C# maj` → `C#`	`C# min` → `C#m`
D	`D` → `D`	`D maj` → `D`	`D min` → `Dm`
D#	`D#` → `D#`	`D# maj` → `D#`	`D# min` → `D#m`
E	`E` → `E`	`E maj` → `E`	`E min` → `Em`
F	`F` → `F`	`F maj` → `F`	`F min` → `Fm`
F#	`F#` → `F#`	`F# maj` → `F#`	`F# min` → `F#m`
G	`G` → `G`	`G maj` → `G`	`G min` → `Gm`
G#	`G#` → `G#`	`G# maj` → `G#`	`G# min` → `G#m`
A	`A` → `A`	`A maj` → `A`	`A min` → `Am`
A#	`A#` → `A#`	`A# maj` → `A#`	`A# min` → `A#m`
B	`B` → `B`	`B maj` → `B`	`B min` → `Bm`

每一格右边是上游 user_key。Loop + G maj + Auto 会变成 { "user_key": "G", "user_loop": true }。再加 "bpm": 120 还会带上 "user_tempo": 120。

示例

{
  "task": "sound",
  "model": "chirp-v6",
  "sound": {
    "description": "Fast cinematic whoosh transition, airy stereo sweep, soft bass hit at the end, clean and short, no reverb tail mush",
    "type": "loop",
    "key": "G maj"
  }
}