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

裁剪已有 Suno clip，通过 [查询任务状态](/zh/api-reference/suno/task) 轮询至 `success`。

<Info>
  **免费**（0 积分）。平台根据 `clip_id` 自动解析 Suno 账号。
</Info>

## 参数

| 字段               | 类型      | 必填 | 说明                           |
| ---------------- | ------- | -- | ---------------------------- |
| `clip_id`        | string  | 是  | 要裁剪的 clip                    |
| `crop_start_s`   | number  | 是  | 起始秒                          |
| `crop_end_s`     | number  | 是  | 结束秒                          |
| `is_crop_remove` | boolean | 否  | `false`=保留选区（默认）；`true`=移除选区 |
| `ui_surface`     | string  | 否  | UI 来源标识，默认 `song_actions`    |

## 结果

```json theme={null}
{
  "status": "complete",
  "action_clip_id": "48d4951a-...",
  "clip": {
    "id": "48d4951a-...",
    "audio_url": "https://cdn1.suno.ai/...",
    "title": "...",
    "status": "complete"
  }
}
```

## 示例

```bash theme={null}
curl -X POST https://api.mountsea.ai/suno/v2/audio/crop \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "clip_id": "5a3c023f-d1ed-4a85-b61e-168dde2b6659",
    "crop_start_s": 0,
    "crop_end_s": 30,
    "is_crop_remove": false
  }'
```


## OpenAPI

````yaml POST /suno/v2/audio/crop
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/audio/crop:
    post:
      tags:
        - suno
      summary: crop audio
      description: >-
        Crop an existing clip (must own the clip). Free operation (0 credits).

        Returns taskId to poll via /status. On success, task result contains the
        new clip info (action_clip_id, status, etc.).
      operationId: ApiPublicController_crop
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CropDto'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskIdDto'
      security:
        - bearerAuth: []
components:
  schemas:
    CropDto:
      type: object
      properties:
        clip_id:
          type: string
          description: 要裁剪的 clip_id（须与账号一致）
        crop_start_s:
          type: number
          minimum: 0
          description: 裁剪起始秒
        crop_end_s:
          type: number
          minimum: 0
          description: 裁剪结束秒
        is_crop_remove:
          type: boolean
          description: 是否移除选区（false = 保留选区，true = 移除选区）
          default: false
        ui_surface:
          type: string
          description: UI 来源标识
          example: song_actions
      required:
        - clip_id
        - crop_start_s
        - crop_end_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

````