Inspiration task - MountSea API

Generate from a playlist you built first. This page is the task=inspiration body. The playlist calls are Create Playlist and Add Clips. The walkthrough is Inspiration. Without persona the upstream task is playlist_condition. With a vox persona it is vox_playlist_condition. POST /suno/v2/generate returns { "taskId" }. Poll Get Task Status. Schema: GET /suno/v2/generate/schema?task=inspiration.

Before you call

POST /suno/v2/playlist/create → playlist_id
POST /suno/v2/playlist/addClips with 1–4 inspiration clips

Parameters

Field	Required	Notes
`task`	Yes	`"inspiration"`
`model`	Yes	`chirp-v6` recommended
`playlist_id`	Yes	From the two calls above
`persona`	No	Vox persona switches the upstream task. `persona_style: "vox"` plus `persona_id` and `artist_clip_id`
`tags`	No	Style of the new song
`vocal_gender`	No	`"m"` or `"f"`
`controls.audio_weight`	No	How closely to follow the playlist, 0–1

Other optional fields: shared list.

Examples

No persona:

{
  "task": "inspiration",
  "model": "chirp-v6",
  "title": "Inspired by jack",
  "tags": "rap, catchy",
  "make_instrumental": false,
  "playlist_id": "119573ff-8e48-4fe6-9029-39c76c9a5597",
  "vocal_gender": "m",
  "controls": { "audio_weight": 0.31 }
}

With a vox persona:

{
  "task": "inspiration",
  "model": "chirp-v6",
  "title": "Inspired by jack",
  "tags": "rap",
  "make_instrumental": true,
  "playlist_id": "119573ff-8e48-4fe6-9029-39c76c9a5597",
  "persona": {
    "artist_clip_id": "f493ed9a-d231-4fe7-938b-2a47857674bd",
    "persona_id": "f563ce69-aaa2-4000-8781-f7c3aefa3842",
    "persona_style": "vox"
  }
}

​Before you call

​Parameters

​Examples

Before you call

Parameters

Examples