---
title: "Remove & Change Background from Videos"
method: POST
path: "/remove-background"
tags: ["Remove Background"]
---

# Remove & Change Background from Videos

`POST /remove-background`

## Request

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

Remove Background from videos, or replace with custom backdrops.

## Request body `multipart/form-data`

- object
  - `video_url` string, uri: Source video URL.
  - `bg_color` string, nullable: Can be a hexcolor code (e.g., #82d5fa, #fff) or a color name (e.g., blue). For full transparency, use 'transparent' or '#00000000'. In this case, the export format .webm will be enforced and applied. For semi-transparency, 4-/8-digit hexcodes are also supported (e.g., #18d4ff87 or #00000066). The default is greenscreen's '#008800'. Use either bg_color or bg_image_url.
  - `bg_image_url` string, uri, nullable: The background image URL. Use either bg_color or bg_image_url. When not provided the default value of the bg_color=#008800 will be applied to the background.

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