> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mountsea.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 音效

> task=sound — 单次或循环，始终是纯器乐

Sounds 页。始终是纯器乐。`sound.description` 同时是官方 tags **和**标题（标题大小写，80 字处截断并加 `...`）。你传的 `prompt` 或 `tags` 都会被覆盖。`max_mode` 会 **HTTP 400**。

`POST /suno/v2/generate` 返回 `{ "taskId" }`。轮询 [查询任务状态](/zh/api-reference/suno/task)。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`。

<span id="key" />

## 调性

不传 `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`。

## 示例

```json theme={null}
{
  "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"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.