Skip to main content
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"
}
FieldTypeRequiredDescription
clip_idsstring[]Yes1–4 clip IDs; also used as the account anchor. Use Batch Upload Session if you need to upload multiple files on one account first.
namestringNoDisplay 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"
  }
}
RequirementDetail
persona_styleMust be "vox" for vox playlist mode; omit for plain playlist_condition
artist_clip_idPersona’s root_clip_id (typically a Studio edit_v3_export clip)
Root clip durationMust cover the vocal range you use when creating the persona
Same accountPlaylist 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"
  }'
Use Generate Schema for the full field list. For Vox personas, see Get Vox Stem and Create Persona.