> ## 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.

# Create Inspiration Playlist

> Create a Suno playlist and bind the owning account (Step 1 of Inspiration)

Creates a Suno playlist and adds 1–4 inspiration clips **atomically** on one account. The account binding is stored so a later `task=inspiration` generate call uses the **same account** automatically.

<Info>
  **Synchronous** — returns `playlist_id` in the response body (HTTP 200/201). No task polling required.
</Info>

<Warning>
  All `clip_ids` must belong to the **same Suno account**. This is the account anchor for the whole Inspiration workflow.
</Warning>

<Tip>
  This is **Step 1** of the [Inspiration workflow](/api-reference/suno/inspiration). Next: [Generate](/api-reference/suno/generate) with `task=inspiration` and `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

````