> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mountsea.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 创建灵感播放列表

> 创建 Suno 播放列表并绑定账号（Inspiration 第 1 步）

在同一 Suno 账号上**原子性**创建播放列表并添加 1\~4 个灵感 clip。账号绑定会被保存，后续 `task=inspiration` 的生成请求将**自动使用同一账号**。

<Info>
  **同步接口** — 响应体直接返回 `playlist_id`（HTTP 200/201），无需轮询任务。
</Info>

<Warning>
  所有 `clip_ids` 必须属于**同一个 Suno 账号**，作为整个 Inspiration 流程的账号锚点。
</Warning>

<Tip>
  这是 [Inspiration 流程](/zh/api-reference/suno/inspiration) 的**第 1 步**。接下来调用 [生成](/zh/api-reference/suno/generate)（`task=inspiration` + `playlist_id`）。
</Tip>


## OpenAPI

````yaml POST /suno/v2/playlist/create
openapi: 3.0.0
info:
  title: Suno AI
  description: API documentation for Suno AI
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.mountsea.ai
    description: API Gateway
security: []
tags:
  - name: suno
    description: ''
  - name: suno/studio
    description: Studio Song Editor（与 audio/crop|fade|reverse 独立）
paths:
  /suno/v2/playlist/create:
    post:
      tags:
        - suno
      summary: create inspiration playlist
      description: >-
        Creates a Suno playlist and adds inspiration clips (1–4) atomically on
        the same account. All clip_ids must belong to the same Suno account —
        the first clip is used as the account anchor. The account binding is
        stored internally so the subsequent /generate (inspiration task)
        automatically uses the same account. Synchronous — result is returned
        immediately.
      operationId: ApiPublicController_createPlaylist
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePlaylistDto'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatePlaylistResDto'
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatePlaylistResDto'
      security:
        - bearerAuth: []
components:
  schemas:
    CreatePlaylistDto:
      type: object
      properties:
        clip_ids:
          minItems: 1
          maxItems: 4
          description: >-
            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.
          example:
            - 30c08405-8be7-4bbf-9b50-f72250fd1531
            - 93d2bfe9-c6d4-42cd-88fc-ee508d4fa6ed
          type: array
          items:
            type: string
        name:
          type: string
          description: Playlist display name. Defaults to "Untitled".
          example: My Inspiration Set
          default: Untitled
      required:
        - clip_ids
    CreatePlaylistResDto:
      type: object
      properties:
        playlist_id:
          type: string
          description: >-
            Suno playlist ID. Pass this to /generate as playlist_id when using
            task=inspiration.
          example: 119573ff-8e48-4fe6-9029-39c76c9a5597
      required:
        - playlist_id
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````