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

# Studio 插入段落

> 阶段一 — 在插入点生成候选填充

在 `insert_at_s` 通过 infill 插入新段落，生成 **2 个候选**。轮询 [查询任务状态](/zh/api-reference/suno/task) 至 `success` 后，调用 [提交插入段落](/zh/api-reference/suno/studioAddSectionCommit)。

<Info>
  **计费**同创建音乐（`create`）。任务结果包含候选 `clips` 以及阶段二所需的 Studio 工程上下文。
</Info>

属于 [Studio 编辑](/zh/api-reference/suno/studio) 分组。

## 参数

| 字段              | 类型     | 必填 | 说明                                   |
| --------------- | ------ | -- | ------------------------------------ |
| `clip_id`       | string | 是  | 源 clip                               |
| `insert_at_s`   | number | 是  | 在原曲中的插入位置（秒）                         |
| `duration_s`    | number | 否  | 新段落时长，4～32 秒（默认 `16`）                |
| `lyrics`        | string | 否  | 新段落歌词；不传则为纯音乐                        |
| `tags`          | string | 否  | 风格；不传则继承原曲风格                         |
| `negative_tags` | string | 否  | 排除风格                                 |
| `model`         | string | 否  | 模型版本（默认 `chirp-v55` / `chirp-fenix`） |
| `title`         | string | 否  | 候选标题                                 |

## 示例

```bash theme={null}
curl -X POST https://api.mountsea.ai/suno/v2/studio/addSection \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "clip_id": "5a3c023f-d1ed-4a85-b61e-168dde2b6659",
    "insert_at_s": 32,
    "duration_s": 16,
    "lyrics": "[Bridge]\nTake me higher tonight",
    "tags": "Pop, Emotional",
    "model": "chirp-v55"
  }'
```

轮询成功后，选定候选 clip id，继续调用 [提交插入段落](/zh/api-reference/suno/studioAddSectionCommit)。


## OpenAPI

````yaml POST /suno/v2/studio/addSection
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/studio/addSection:
    post:
      tags:
        - suno/studio
      summary: Studio add section (phase 1)
      description: >-
        在 insert_at_s 插入新段落，走 infill 生成 2 个候选（计费同创建音乐）。通过 clip_id 同账号选号。任务结果含
        clips + studio 上下文；选定后调 addSectionCommit。
      operationId: ApiStudioController_addSection
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StudioAddSectionDto'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskIdDto'
      security:
        - bearerAuth: []
components:
  schemas:
    StudioAddSectionDto:
      type: object
      properties:
        clip_id:
          type: string
          description: 原歌曲 clip_id
        insert_at_s:
          type: number
          minimum: 0
          description: 在原曲的这个秒数处插入新段落
        duration_s:
          type: number
          minimum: 4
          maximum: 32
          description: 新段落时长，范围 4～32，默认 16
          default: 16
        lyrics:
          type: string
          description: 新段落歌词；不传则为纯音乐
        tags:
          type: string
          description: 风格；不传则继承原曲风格
        negative_tags:
          type: string
          description: 排除风格
        model:
          type: string
          description: 模型版本，默认 chirp-v55 / chirp-fenix
          example: chirp-v55
        title:
          type: string
          description: 候选标题
      required:
        - clip_id
        - insert_at_s
    TaskIdDto:
      type: object
      properties:
        taskId:
          type: string
          description: task id. Use this id to query task status.
          example: 15c257ff-43f7-4678-bd41-202ad6b8488b
      required:
        - taskId
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````