---
title: "Crop Video"
method: POST
path: "/crop"
tags: ["Edit"]
---

# Crop Video

`POST /crop`

Crop the input video clip to the desired size.

## Request body

- object
  - `video_url` string, uri — Source video URL.
  - `width` integer — Width of the outcome video. If the new width is larger than the original width, the blurry mirror effect should be applied to the additional part. The measurement unit is px. The default value is the original width. Value must be at least 16 px.
  - `height` integer — Height of the output video. If the new height is larger than the original height, the blurry mirror effect should be applied to the additional part. The measurement unit is px. The default value is the original height. Value must be at least 16 px.
  - `start_x` integer — The starting x location of the crop in px as measured from the left edge.
  - `start_y` integer — The starting y location of the crop in px as measured from the bottom edge.
  - `export` object
    - `format` 'MOV' | 'MP4' | 'WEBM' | 'GIF' — Optionally select one of the output video formats (MP4 is chosen if left blank). Container options are as follows * MOV * MP4 * WEBM * GIF
    - `frame_rate` integer — The output video frame rate.
    - `bitrate` integer — The output video bitrate in kb/s. Leave empty to set automatically and optimize accordingly.

## Response `202`

Requested successfully accepted when doing asynchronous transformation.

- object
  - `transaction_id` string, nullable
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `403` — Forbidden
- `404` — Not Found
- `405` — Method Not Allowed
- `413` — Request Entity Too Large
- `415` — Unsupported Media Type
- `429` — Too Many Requests
- `431` — Request Header Fields Too Large
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/picsart/apis/picsart-programmable-image-apis.md) · [All operations](https://skmtc.net/picsart/apis/picsart-programmable-image-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/picsart/picsart-programmable-image-apis/revisions/726b2a637ae8/schema)