> ## 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.

# Inspiration（灵感播放列表）

> 基于真实 Suno 播放列表的灵感生成两步流程

基于**真实 Suno 播放列表**生成音乐。旧的简化模式（`playlist_id: "inspiration"` + `playlist_clip_ids`）已**废弃**——必须先创建播放列表，再将 `playlist_id` 传给 `/generate`。

## 流程概览

```
Step 1: POST /suno/v2/playlist/create
        → 返回 playlist_id（同时绑定账号）

Step 2: POST /suno/v2/generate
        → task=inspiration + playlist_id + persona（可选）
```

<Warning>
  Step 1 中的所有 `clip_ids` 必须属于**同一个 Suno 账号**。创建播放列表时系统会记录该账号，调用 `task=inspiration` 的 `/generate` 时会**强制使用同一账号**。
</Warning>

***

## Step 1 — 创建播放列表

[创建播放列表](/zh/api-reference/suno/playlistCreate) — 同步接口，立即返回 `playlist_id`。在 `clip_ids` 中传入 **1\~4 个 clip**，一次调用即完成添加。

```json theme={null}
{
  "clip_ids": ["30c08405-8be7-4bbf-9b50-f72250fd1531"],
  "name": "My Inspiration Set"
}
```

| 字段         | 类型        | 必填 | 说明                                                                                              |
| ---------- | --------- | -- | ----------------------------------------------------------------------------------------------- |
| `clip_ids` | string\[] | 是  | 1\~4 个 clip ID，兼作**账号锚点**。若需先批量上传同账号文件，请用 [批量上传 Session](/zh/api-reference/suno/uploadSession)。 |
| `name`     | string    | 否  | 播放列表名称，默认 `"Untitled"`                                                                          |

**响应：**

```json theme={null}
{ "playlist_id": "42af5178-18a4-4fe7-b8f2-2f80c53b4d94" }
```

***

## Step 2 — 生成音乐

[生成音乐](/zh/api-reference/suno/generate)，`task=inspiration`。通过 [查询任务状态](/zh/api-reference/suno/task) 轮询至 `success`。

### 2a. 无 Persona

Suno 内部 task：`playlist_condition`

```json theme={null}
{
  "task": "inspiration",
  "model": "chirp-v55",
  "title": "Inspired by jack",
  "tags": "rap歌曲，顺口",
  "make_instrumental": true,
  "playlist_id": "42af5178-18a4-4fe7-b8f2-2f80c53b4d94"
}
```

### 2b. 带 Vox Persona

Suno 内部 task：`vox_playlist_condition`

```json theme={null}
{
  "task": "inspiration",
  "model": "chirp-v55",
  "title": "Inspired by jack",
  "tags": "rap歌曲，顺口",
  "make_instrumental": false,
  "playlist_id": "42af5178-18a4-4fe7-b8f2-2f80c53b4d94",
  "persona": {
    "persona_id": "d69c3de1-17f4-4850-8125-83d5111078da",
    "artist_clip_id": "4fa20262-2126-4ec2-9846-e668211a8c7b",
    "persona_style": "vox"
  }
}
```

| 要求               | 说明                                                         |
| ---------------- | ---------------------------------------------------------- |
| `persona_style`  | 必须为 `"vox"` 才走 vox 播放列表模式                                  |
| `artist_clip_id` | Persona 的 `root_clip_id`（通常为 Studio `edit_v3_export` clip） |
| 同账号              | 播放列表与 Persona 须在同一 Suno 账号上                                |

***

## 账号一致性

```
playlist/create  →  记录 PlaylistCreate（playlist_id + accountId）
        ↓
generate (inspiration)  →  按 playlist_id 解析账号 → 强制同账号
```

无需传入账号 ID，平台根据播放列表自动解析。

***

## 完整示例

<CodeGroup>
  ```bash Step 1 — 创建播放列表 theme={null}
  curl -X POST https://api.mountsea.ai/suno/v2/playlist/create \
    -H "Authorization: Bearer your-api-key" \
    -H "Content-Type: application/json" \
    -d '{
      "clip_ids": ["30c08405-8be7-4bbf-9b50-f72250fd1531"],
      "name": "My Inspiration Set"
    }'
  ```

  ```bash Step 2 — 生成 theme={null}
  curl -X POST https://api.mountsea.ai/suno/v2/generate \
    -H "Authorization: Bearer your-api-key" \
    -H "Content-Type: application/json" \
    -d '{
      "task": "inspiration",
      "model": "chirp-v55",
      "title": "Inspired by jack",
      "tags": "rap歌曲，顺口",
      "playlist_id": "42af5178-18a4-4fe7-b8f2-2f80c53b4d94"
    }'
  ```

  ```bash 轮询 theme={null}
  curl "https://api.mountsea.ai/suno/v2/status?taskId=YOUR_TASK_ID" \
    -H "Authorization: Bearer your-api-key"
  ```
</CodeGroup>

<Tip>
  完整字段见 [Generate Schema](/zh/api-reference/suno/generateSchema?task=inspiration)。Vox Persona 见 [Get Vox Stem](/zh/api-reference/suno/getVoxStem) 与 [创建 Persona](/zh/api-reference/suno/persona)。
</Tip>