> ## 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 编辑

> 时间线编辑 — 裁剪、删除、复制与插入段落

Suno **Studio** API 在同一 Suno 账号上编辑已有 clip（通过 `clip_id` 解析账号），并导出为新歌。

大多数 Studio 操作**免费（0 积分）**。例外是 [插入段落](/zh/api-reference/suno/studioAddSection)：阶段一走 infill 生成（计费同创建音乐），阶段二提交为免费。

## 账号绑定

所有 Studio 端点通过 `clip_id` 解析 Suno 账号。该 clip 必须属于你的 API Key 可用账号。

## 端点一览

| 端点                                 | 方法   | 积分 | 说明                         |
| ---------------------------------- | ---- | -- | -------------------------- |
| `/suno/v2/studio/crop`             | POST | 免费 | 仅保留 `[start_s, end_s)` 并导出 |
| `/suno/v2/studio/removeSection`    | POST | 免费 | 删除一个或多个区间                  |
| `/suno/v2/studio/duplicate`        | POST | 免费 | 复制区间并插入                    |
| `/suno/v2/studio/addSection`       | POST | 计费 | 阶段一 — 生成 2 个候选填充           |
| `/suno/v2/studio/addSectionCommit` | POST | 免费 | 阶段二 — 提交选定候选               |

## 插入段落流程（两阶段）

<Steps>
  <Step title="生成候选">
    调用 [插入段落](/zh/api-reference/suno/studioAddSection)，传入 `clip_id` 与 `insert_at_s`。轮询 [查询任务状态](/zh/api-reference/suno/task) 至 `success`。结果包含候选 `clips` 与 Studio 工程上下文。
  </Step>

  <Step title="提交选定">
    调用 [提交插入段落](/zh/api-reference/suno/studioAddSectionCommit)，传入阶段一 `taskId` 与选定的 `candidate_clip_id`。账号复用阶段一已绑定账号 — 不要用原曲 `taskId` 做选号。
  </Step>
</Steps>

## 快速示例 — 裁剪

```bash theme={null}
curl -X POST https://api.mountsea.ai/suno/v2/studio/crop \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "clip_id": "5a3c023f-d1ed-4a85-b61e-168dde2b6659",
    "start_s": 0,
    "end_s": 45,
    "title": "Summer Vibes (Cropped)"
  }'
```

然后轮询 `GET /suno/v2/status?taskId=...` 直至完成。