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

# Add Clips to Playlist

> Append clips to an inspiration playlist (optional Step 2)

Adds 1–4 more clips to a playlist created by [Create Inspiration Playlist](/api-reference/suno/playlistCreate).

<Info>
  **Synchronous** — returns `{}` on success (HTTP 201). No task polling required.
</Info>

| Field         | Required | Description                                                |
| ------------- | -------- | ---------------------------------------------------------- |
| `playlist_id` | Yes      | ID from `/playlist/create`                                 |
| `clip_id`     | Yes      | One of the original inspiration clips (account resolution) |
| `clip_ids`    | Yes      | 1–4 clip IDs to add (same account as Step 1)               |

<Tip>
  Part of the [Inspiration workflow](/api-reference/suno/inspiration). Skip this step if Step 1 already included all clips you need.
</Tip>


## OpenAPI

````yaml POST /suno/v2/playlist/addClips
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/addClips:
    post:
      tags:
        - suno
      summary: add more clips to an existing playlist
      description: >-
        Advanced: adds extra clips to a playlist created by /playlist/create.
        Requires clip_id (one of the original inspiration clips) to resolve the
        account. Synchronous — returns {} on success.
      operationId: ApiPublicController_addClipsToPlaylist
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddClipsToPlaylistDto'
      responses:
        '201':
          description: ''
      security:
        - bearerAuth: []
components:
  schemas:
    AddClipsToPlaylistDto:
      type: object
      properties:
        playlist_id:
          type: string
          description: Playlist ID returned by /playlist/create.
          example: 119573ff-8e48-4fe6-9029-39c76c9a5597
        clip_id:
          type: string
          description: >-
            One of the original inspiration clip IDs (used to resolve the
            account — must match the account used in /playlist/create).
          example: 30c08405-8be7-4bbf-9b50-f72250fd1531
        clip_ids:
          minItems: 1
          maxItems: 4
          description: >-
            Additional clip IDs to add to the playlist (1–4, all must belong to
            the same Suno account).
          example:
            - 30c08405-8be7-4bbf-9b50-f72250fd1531
          type: array
          items:
            type: string
      required:
        - playlist_id
        - clip_id
        - clip_ids
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````