> ## 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 (Playlist)

> Two-step workflow for inspiration-based music generation

Generate music conditioned on a **real Suno playlist**. The legacy shortcut (`playlist_id: "inspiration"` with `playlist_clip_ids`) is **deprecated** — you must create a playlist first, then pass its `playlist_id` to `/generate`.

## Workflow

```
Step 1: POST /suno/v2/playlist/create
        → playlist_id (account bound atomically)

Step 2: POST /suno/v2/generate
        → task=inspiration + playlist_id + optional persona
```

<Warning>
  All `clip_ids` in Step 1 must belong to the **same Suno account**. The system stores that account when the playlist is created and **forces the same account** when you call `/generate` with `task=inspiration`.
</Warning>

***

## Step 1 — Create playlist

[Create Playlist](/api-reference/suno/playlistCreate) — synchronous, returns `playlist_id` immediately. Pass **1–4 clip IDs** in `clip_ids`; they are added to the playlist in one call.

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

| Field      | Type      | Required | Description                                                                                                                                                                 |
| ---------- | --------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `clip_ids` | string\[] | Yes      | 1–4 clip IDs; also used as the **account anchor**. Use [Batch Upload Session](/api-reference/suno/uploadSession) if you need to upload multiple files on one account first. |
| `name`     | string    | No       | Display name, default `"Untitled"`                                                                                                                                          |

**Response:**

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

***

## Step 2 — Generate

[Generate Music](/api-reference/suno/generate) with `task=inspiration`. Poll [Get Task Status](/api-reference/suno/task) until `success`.

### 2a. Inspiration only (no persona)

Suno internal task: `playlist_condition`

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

### 2b. Inspiration + Vox persona

Suno internal task: `vox_playlist_condition`

```json theme={null}
{
  "task": "inspiration",
  "model": "chirp-v55",
  "title": "Inspired by jack",
  "tags": "rap, catchy",
  "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"
  }
}
```

| Requirement        | Detail                                                                     |
| ------------------ | -------------------------------------------------------------------------- |
| `persona_style`    | Must be `"vox"` for vox playlist mode; omit for plain `playlist_condition` |
| `artist_clip_id`   | Persona's `root_clip_id` (typically a Studio `edit_v3_export` clip)        |
| Root clip duration | Must cover the vocal range you use when creating the persona               |
| Same account       | Playlist and persona must exist on the account bound at playlist creation  |

***

## Account consistency

```
playlist/create  →  stored as PlaylistCreate (playlist_id + accountId)
        ↓
generate (inspiration)  →  resolve account by playlist_id → same Suno account
```

You do not pass an account ID — the platform resolves it from the playlist.

***

## Full example

<CodeGroup>
  ```bash Step 1 — Create playlist 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 — Generate 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, catchy",
      "playlist_id": "42af5178-18a4-4fe7-b8f2-2f80c53b4d94"
    }'
  ```

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

<Tip>
  Use [Generate Schema](/api-reference/suno/generateSchema?task=inspiration) for the full field list. For Vox personas, see [Get Vox Stem](/api-reference/suno/getVoxStem) and [Create Persona](/api-reference/suno/persona).
</Tip>