跳转到主要内容
POST
/
suno
/
v2
/
playlist
/
create
create inspiration playlist
curl --request POST \
  --url https://api.mountsea.ai/suno/v2/playlist/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "clip_ids": [
    "30c08405-8be7-4bbf-9b50-f72250fd1531",
    "93d2bfe9-c6d4-42cd-88fc-ee508d4fa6ed"
  ],
  "name": "My Inspiration Set"
}
'
{
  "playlist_id": "119573ff-8e48-4fe6-9029-39c76c9a5597"
}
在同一 Suno 账号上原子性创建播放列表并添加 1~4 个灵感 clip。账号绑定会被保存，后续 task=inspiration 的生成请求将自动使用同一账号。
同步接口 — 响应体直接返回 playlist_id（HTTP 200/201），无需轮询任务。
所有 clip_ids 必须属于同一个 Suno 账号，作为整个 Inspiration 流程的账号锚点。
这是 Inspiration 流程 的第 1 步。接下来调用 生成（task=inspiration + playlist_id）。

授权

​
Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
​
clip_ids
string[]
必填

Inspiration clip IDs (1–4). All must belong to the same Suno account. Used as account anchor: the playlist will be created on the account that owns these clips, and all clips will be added to the playlist atomically.

Required array length: 1 - 4 elements
示例:
[
  "30c08405-8be7-4bbf-9b50-f72250fd1531",
  "93d2bfe9-c6d4-42cd-88fc-ee508d4fa6ed"
]
​
name
string
默认值:Untitled

Playlist display name. Defaults to "Untitled".

示例:

"My Inspiration Set"

响应

​
playlist_id
string
必填

Suno playlist ID. Pass this to /generate as playlist_id when using task=inspiration.

示例:

"119573ff-8e48-4fe6-9029-39c76c9a5597"