> ## 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 — Custom 写词或 Simple 想法

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

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

口播是同一个任务。见 [语音](/zh/api-reference/suno/generateSpeech)。

`POST /suno/v2/generate` 返回 `{ "taskId" }`。轮询 [查询任务状态](/zh/api-reference/suno/task)。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 地址。见 [图片](#images) |
| `persona` | 否 | 有它就保持 Custom。和 `image_urls` 一起 → **400**。Voice Persona：`is_voice: true` 时只需要 `persona_id` |
| `is_speech` / `backing_music` | 否 | 仅语音。见 [语音](/zh/api-reference/suno/generateSpeech) |

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

<span id="images" />

## 图片

`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 — 自己写词：

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

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

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

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

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

其他可选字段：[共用列表](/zh/api-reference/suno/generate-tasks#shared-optional-fields)。


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