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

# 向播放列表追加 Clip

> 向灵感播放列表追加 clip（可选第 2 步）

向 [创建播放列表](/zh/api-reference/suno/playlistCreate) 返回的播放列表追加 1\~4 个 clip。

<Info>
  **同步接口** — 成功时返回 `{}`（HTTP 201），无需轮询。
</Info>

| 字段            | 必填 | 说明                          |
| ------------- | -- | --------------------------- |
| `playlist_id` | 是  | `/playlist/create` 返回的 ID   |
| `clip_id`     | 是  | 原始灵感 clip 之一（用于解析账号）        |
| `clip_ids`    | 是  | 要追加的 1\~4 个 clip（与第 1 步同账号） |

<Tip>
  属于 [Inspiration 流程](/zh/api-reference/suno/inspiration)。若第 1 步已包含全部 clip，可跳过本步。
</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

````