---
title: "Media · Video · Remove a video background"
method: POST
path: "/api/v1/tools/remove-video-background"
tags: ["video"]
---

# Media · Video · Remove a video background

`POST /api/v1/tools/remove-video-background`

## Request

- Base URL: `https://api.simplified.com`
- URL: `https://api.simplified.com/api/v1/tools/remove-video-background`
- Auth: API key in header `Authorization`

Remove a video background using Bria. Source must be publicly accessible and fit the backend duration/resolution limits. Returns task_id; getTaskResult retrieves the output.

## Request body

- object
  - `video_url` string, uri, required
  - `mode` string, required: Background mode: transparent, black, white, gray, red, green, blue, yellow, cyan, magenta, or orange. Transparency produces WebM; solid backgrounds produce MP4.

## Response `202`

Resource or asynchronous submission result.

- AsyncTaskResponse
  - `task_id` string, required: Poll GET /api/v1/tasks/{task_id} until SUCCESS or FAILURE.

---

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