Inspiration (Playlist) - MountSea API

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

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.

Step 1 — Create playlist

Create Playlist — synchronous, returns playlist_id immediately. Pass 1–4 clip IDs in clip_ids; they are added to the playlist in one call.

{
  "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 if you need to upload multiple files on one account first.
`name`	string	No	Display name, default `"Untitled"`

Response:

{ "playlist_id": "42af5178-18a4-4fe7-b8f2-2f80c53b4d94" }

Step 2 — Generate

Generate Music with task=inspiration. Poll Get Task Status until success.

2a. Inspiration only (no persona)

Suno internal task: playlist_condition

{
  "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

{
  "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

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"
  }'

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"
  }'

curl "https://api.mountsea.ai/suno/v2/status?taskId=YOUR_TASK_ID" \
  -H "Authorization: Bearer your-api-key"

Use Generate Schema for the full field list. For Vox personas, see Get Vox Stem and Create Persona.

​Workflow

​Step 1 — Create playlist

​Step 2 — Generate

​2a. Inspiration only (no persona)

​2b. Inspiration + Vox persona

​Account consistency

​Full example

Workflow

Step 1 — Create playlist

Step 2 — Generate

2a. Inspiration only (no persona)

2b. Inspiration + Vox persona

Account consistency

Full example