> ## 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=create，加上 is_speech

语音**不是**新任务。它是 `task=create` 加上 `is_speech: true`，计费仍按 `create`。不传 `is_speech`（或传 `false`）就是普通歌曲，这个字段不会发到上游。

`is_speech` 和 `backing_music` 只在值为 `true`、且任务是 `create` 时生效。官方抓包用 `chirp-v6-mini`。

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

## 参数

| 字段 | 必填 | 说明 |
| - | - | - |
| `task` | 是 | `"create"` |
| `model` | 是 | 官方抓包是 `chirp-v6-mini`。`chirp-v6` 也可以 |
| `is_speech` | 语音必填 | `true` |
| `prompt` | 写稿 | 要说的话。非空 → Custom |
| `tags` | 写稿 | 声音风格：语速、语气、「不要耳语」 |
| `gpt_description_prompt` | 想法 | 一句话描述。不传 `prompt` 和 `persona` |
| `vocal_gender` | 否 | `"f"` 或 `"m"`。不传 = 不指定 |
| `backing_music` | 否 | `true` = 人声下面垫音乐。想法模式除非要垫乐，否则不要传 |
| `controls.aug_creativity` | 否 | 变化幅度，0–4。`4` = 最大 |

## 示例

自己写稿。`prompt` 是台词，`tags` 是怎么说：

```json theme={null}
{
  "task": "create",
  "model": "chirp-v6-mini",
  "prompt": "一张照片，一首歌，一支专属 MV。\n上传你的形象，选好音乐，几分钟就能生成电影感音乐视频。",
  "tags": "温暖女声，吐字清晰，语速中等偏慢，亲和有自信，不要耳语也不要喊叫",
  "vocal_gender": "f",
  "is_speech": true,
  "backing_music": true,
  "controls": { "aug_creativity": 4 }
}
```

只给想法。不要传 `prompt`、`persona`，除非要垫乐也不要传 `backing_music`：

```json theme={null}
{
  "task": "create",
  "model": "chirp-v6-mini",
  "gpt_description_prompt": "A fiery halftime locker-room speech from a coach whose team is down twenty points, building from a low growl to a full-throated roar",
  "vocal_gender": "f",
  "is_speech": true
}
```


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