Inspiration（灵感播放列表）

基于真实 Suno 播放列表生成音乐。旧的简化模式（playlist_id: "inspiration" + playlist_clip_ids）已废弃——必须先创建播放列表，再将 playlist_id 传给 /generate。

流程概览

Step 1: POST /suno/v2/playlist/create
        → 返回 playlist_id（同时绑定账号）

Step 2: POST /suno/v2/generate
        → task=inspiration + playlist_id + persona（可选）

Step 1 中的所有 clip_ids 必须属于同一个 Suno 账号。创建播放列表时系统会记录该账号，调用 task=inspiration 的 /generate 时会强制使用同一账号。

Step 1 — 创建播放列表

创建播放列表 — 同步接口，立即返回 playlist_id。在 clip_ids 中传入 1~4 个 clip，一次调用即完成添加。

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

字段	类型	必填	说明
`clip_ids`	string[]	是	1~4 个 clip ID，兼作账号锚点。若需先批量上传同账号文件，请用批量上传 Session。
`name`	string	否	播放列表名称，默认 `"Untitled"`

响应：

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

Step 2 — 生成音乐

生成音乐，task=inspiration。通过查询任务状态轮询至 success。

2a. 无 Persona

Suno 内部 task：playlist_condition

{
  "task": "inspiration",
  "model": "chirp-v55",
  "title": "Inspired by jack",
  "tags": "rap歌曲，顺口",
  "make_instrumental": true,
  "playlist_id": "42af5178-18a4-4fe7-b8f2-2f80c53b4d94"
}

2b. 带 Vox Persona

Suno 内部 task：vox_playlist_condition

{
  "task": "inspiration",
  "model": "chirp-v55",
  "title": "Inspired by jack",
  "tags": "rap歌曲，顺口",
  "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"
  }
}

要求	说明
`persona_style`	必须为 `"vox"` 才走 vox 播放列表模式
`artist_clip_id`	Persona 的 `root_clip_id`（通常为 Studio `edit_v3_export` clip）
同账号	播放列表与 Persona 须在同一 Suno 账号上

账号一致性

playlist/create  →  记录 PlaylistCreate（playlist_id + accountId）
        ↓
generate (inspiration)  →  按 playlist_id 解析账号 → 强制同账号

无需传入账号 ID，平台根据播放列表自动解析。

完整示例

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歌曲，顺口",
    "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"

完整字段见 Generate Schema。Vox Persona 见 Get Vox Stem 与创建 Persona。

​流程概览

​Step 1 — 创建播放列表

​Step 2 — 生成音乐

​2a. 无 Persona

​2b. 带 Vox Persona

​账号一致性

​完整示例

流程概览

Step 1 — 创建播放列表

Step 2 — 生成音乐

2a. 无 Persona

2b. 带 Vox Persona

账号一致性

完整示例