> ## 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 提交插入段落

> 阶段二 — 提交选定的插入段落候选

提交在 [插入段落](/zh/api-reference/suno/studioAddSection) 中选定的候选。通过 [查询任务状态](/zh/api-reference/suno/task) 轮询至 `success`。

<Info>
  **免费**（0 积分）。`taskId` 是**阶段一任务 id**，用于读取 Studio 工程上下文 — 不是原曲选号用的 `taskId`。账号复用阶段一已绑定账号。
</Info>

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

## 参数

| 字段                  | 类型     | 必填 | 说明                        |
| ------------------- | ------ | -- | ------------------------- |
| `taskId`            | string | 是  | 阶段一（`addSection`）返回的任务 id |
| `candidate_clip_id` | string | 是  | 阶段一 `clips` 中选中的候选 id     |
| `title`             | string | 否  | 最终新歌标题                    |

## 示例

```bash theme={null}
curl -X POST https://api.mountsea.ai/suno/v2/studio/addSectionCommit \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "candidate_clip_id": "48d4951a-d1ed-4a85-b61e-168dde2b6659",
    "title": "Summer Vibes (Extended Bridge)"
  }'
```


## OpenAPI

````yaml POST /suno/v2/studio/addSectionCommit
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/addSectionCommit:
    post:
      tags:
        - suno/studio
      summary: Studio add section commit (phase 2)
      description: taskId 仅用于读取阶段一结果中的 studio 工程上下文（不是选号用的原曲 taskId）；账号复用阶段一已绑定账号。积分 0。
      operationId: ApiStudioController_addSectionCommit
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StudioAddSectionCommitDto'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskIdDto'
      security:
        - bearerAuth: []
components:
  schemas:
    StudioAddSectionCommitDto:
      type: object
      properties:
        taskId:
          type: string
          description: 阶段一（addSection）返回的任务 id，用于取 studio 工程上下文
          example: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
        candidate_clip_id:
          type: string
          description: 阶段一 clips 中选中的候选 id
        title:
          type: string
          description: 最终新歌标题
      required:
        - taskId
        - candidate_clip_id
    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

````