跳转到主要内容
基于真实 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_idsstring[]是1~4 个 clip ID，兼作账号锚点。若需先批量上传同账号文件，请用 批量上传 Session。
namestring否播放列表名称，默认 "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_idPersona 的 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"
  }'
完整字段见 Generate Schema。Vox Persona 见 Get Vox Stem 与 创建 Persona。