---
title: "Adjust Video"
method: POST
path: "/adjust"
tags: ["Effects"]
---

# Adjust Video

`POST /adjust`

## Request

- Base URL: `https://video-api.picsart.io/v1`
- URL: `https://video-api.picsart.io/v1/adjust`
- Auth: API key in header `X-Picsart-API-Key`

Adjusts the input video file with 14 different options.
**Options:**
  * Adjust audio and/or volume
  * Adjust video volume
  * Adjust brightness and/or contrast
  * Adjust clarity and/or saturation
  * Adjust speed and/or reverse the video
  * Adjust hue and/or shadows
  * Adjust highlights and/or temperature
  * Adjust noise or sharpen the video
  * Adjust vignette

If you choose an adjustment setting value out of the allowed range, the default value of 0 is used instead.

## Request body

- object
  - `video_url` string, uri: Source video URL.
  - `audio_url` string, nullable: The sound file url.
  - `audio_volume` integer: The volume of the audio.
  - `video_volume` integer: The volume of the video.
  - `brightness` integer: Enter an integer value from -100 to 100.
  - `contrast` integer: Enter an integer value from -100 to 100.
  - `clarity` integer: Enter an integer value from -100 to 100.
  - `saturation` integer: Enter an integer value from -100 to 100.
  - `hue` integer: Enter an integer value from -100 to 100.
  - `shadows` integer: Enter an integer value from -100 to 100.
  - `highlights` integer: Enter an integer value from -100 to 100.
  - `temperature` integer: Enter an integer value from -100 to 100.
  - `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`

Request successfully accepted for an asynchronous transformation.

- object
  - `transaction_id` string, nullable
  - `status` 'success' | 'error' | 'processing' | 'queued'

## 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
- `529`: Overloaded. The model provider is overloaded and could not complete this request. Please retry shortly, or switch to a different model.

---

[API](https://skmtc.dev/picsart/apis/picsart-programmable-video-apis.md) - [All operations](https://skmtc.dev/picsart/apis/picsart-programmable-video-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/picsart/apis/picsart-programmable-video-apis/revisions/e3f1d0bea43b?raw)