---
title: "Cut clips from an imported video"
method: POST
path: "/v1/media/clips"
tags: ["Media"]
---

# Cut clips from an imported video

`POST /v1/media/clips`

## Request

- Base URL: `https://www.postquick.ai/api`
- URL: `https://www.postquick.ai/api/v1/media/clips`
- Auth: HTTP bearer

Starts cutting one or more clips from a finished import. Each clip is its own job and is saved to the user's media library; poll getMediaJob for each until it is `ready`. The original video is not changed.

## Request body

- object
  - `importId` string, uuid, required: The id of a `ready` import job.
  - `clips` object[], required
    - `start` number, required: Where the clip starts, in seconds.
    - `end` number, required: Where the clip ends, in seconds. At least 1 second after `start`.
    - `shape` 'original' | '9:16' | '1:1' | '16:9': The frame: `original`, or `9:16` (1080x1920), `1:1` (1080x1080), `16:9` (1920x1080).
    - `fit` 'crop' | 'fit': When the video is a different shape: `crop` fills the frame, `fit` shows everything with bars.

## Response `201`

The clips have started.

- object
  - `success` true, required
  - `data` object, required
    - `jobs` MediaJob[], required
      - `id` string, uuid, required
      - `type` 'import' | 'clip', required
      - `status` 'queued' | 'processing' | 'ready' | 'failed', required: `queued` and `processing` are still running; poll getMediaJob until `ready` or `failed`.
      - `sourceUrl` string, nullable, required: The post link an import came from; null for a clip.
      - `title` string, nullable, required
      - `resultUrl` string, nullable, required: The stored video, once `ready`. Use it as `videoUrl` in createVideo or createStory.
      - `durationSeconds` number, nullable, required
      - `width` number, nullable, required
      - `height` number, nullable, required
      - `sizeBytes` number, nullable, required
      - `error` string, nullable, required: Why the job failed, in words for the user.
      - `createdAt` string, required

## Other responses

- `403`: The user's storage is full.
- `404`: No ready import with that id belongs to the user.

---

[API](https://skmtc.dev/postquick/apis/postquickai-api.md) · [All operations](https://skmtc.dev/postquick/apis/postquickai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postquick/apis/postquickai-api/revisions/d9bc2bcf3042?raw)