> For the complete documentation index, see [llms.txt](https://developer.topazlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.topazlabs.com/video-models/video-utilities/video-foreground-object-removal.md).

# Video Foreground Object Removal

Remove unwanted objects from video

### Model Overview

**Video Foreground Object Removal** is a video cleanup model designed to remove foreground elements from footage using intelligent pixel reconstruction.

It combines a source video with a tracked matte to remove the selected object across frames, filling missing areas based on surrounding visual information to maintain continuity. Well suited for both creative editing and production workflows, it eliminates the need for a clean plate while preserving the original look of the footage.

### Key Capabilities

* Combines video and a tracked matte to remove foreground objects across frames without requiring a clean plate or paint.
* Outputs background-reconstructed video and supports mask-based workflows for integration into pipelines.
* Reconstructs removed areas with consistent clarity, color, and detail for natural results.

### Pricing

{% hint style="info" %}
For more accurate pricing, we recommend checking out our [Credit Calculator](https://developer.topazlabs.com/credit-calculator).
{% endhint %}

### **Endpoint**

[https://api.topazlabs.com/video](<https://api.topazlabs.com/video&#xA;&#xA;>)

### **Parameters**

`model` <a class="button secondary medium">string</a><a class="button secondary medium">required</a>

Model name: <a class="button secondary medium">"remove-1"</a>

***

`inputFrameCount` <a class="button secondary medium">integer</a><a class="button secondary medium">optional</a><a class="button secondary medium">default="null"</a>

Input video number of frames.

***

`inputFrameRate` <a class="button secondary medium">decimal</a><a class="button secondary medium">optional</a><a class="button secondary medium">default="null"</a>

Input video frame rate in frames per second.

***

`inputHeight` <a class="button secondary medium">integer</a><a class="button secondary medium">optional</a><a class="button secondary medium">default=1080</a>

Input video height in pixels.

***

`inputWidth` <a class="button secondary medium">integer</a><a class="button secondary medium">optional</a><a class="button secondary medium">default=1920</a>

Input vidoe width in pixels.

***

`outputHeight` <a class="button secondary medium">integer</a><a class="button secondary medium">optional</a><a class="button secondary medium">default=1080</a>

Output video height in pixels.

***

`outputWidth` <a class="button secondary medium">integer</a><a class="button secondary medium">optional</a><a class="button secondary medium">default=1920</a>

Output video width in pixels.

***

`videoBitDepth` <a class="button secondary medium">integer</a><a class="button secondary medium">optional</a><a class="button secondary medium">default="null"</a>

Output video bit depth.

***

`videoCodec` <a class="button secondary medium">string</a><a class="button secondary medium">optional</a><a class="button secondary medium">default="null"</a>

Output video codec.

Possible values: <a class="button secondary medium">"ffv1"</a>, <a class="button secondary medium">"prores"</a>, <a class="button secondary medium">"vp9"</a>

***

`videoProfile` <a class="button secondary medium">string</a><a class="button secondary medium">optional</a><a class="button secondary medium">default="null"</a>

Output video profile.

Possible values: <a class="button secondary medium">420</a>, <a class="button secondary medium">422</a>, <a class="button secondary medium">444</a>

`inputHeight` <a class="button secondary medium">integer</a><a class="button secondary medium">optional</a><a class="button secondary medium">default="null"</a>

Input image height in pixels.

***

`inputWidth` <a class="button secondary medium">integer</a><a class="button secondary medium">optional</a><a class="button secondary medium">default="null"</a>

Input image width in pixels.

***

`outputHeight` <a class="button secondary medium">integer</a><a class="button secondary medium">optional</a><a class="button secondary medium">default="null"</a>

Output image height in pixels.

***

`outputWidth` <a class="button secondary medium">integer</a><a class="button secondary medium">optional</a><a class="button secondary medium">default="null"</a>

Output image width in pixels.

***

`maskUri` <a class="button secondary medium">string</a><a class="button secondary medium">optional</a><a class="button secondary medium">default="null"</a>

URI for mask input.

***

`referenceUri` <a class="button secondary medium">string</a><a class="button secondary medium">optional</a><a class="button secondary medium">default="null"</a>

URI for reference image input.

***

`watermark` <a class="button secondary medium">boolean</a><a class="button secondary medium">optional</a><a class="button secondary medium">default="false"</a>

Whether to watermark the output.

{% hint style="info" %}
This model takes an *input video* & *mask video* as inputs
{% endhint %}

### Example Inputs

{% columns %}
{% column %}
{% file src="/files/pEZLE2cgJNdSUIr3XGGu" %}

{% file src="/files/ywPTBVXZmAmTguAvkKp9" %}

{% file src="/files/JRHyDpISZ52j6qCDUH01" %}

{% endcolumn %}

{% column %}
{% file src="/files/iIM65UncImCPJ4eTZxsR" %}

{% file src="/files/r3VjXhMykYREfUaGrBAD" %}

{% file src="/files/TSvhXFAG7SQESxmF0Ttn" %}

{% endcolumn %}
{% endcolumns %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.topazlabs.com/video-models/video-utilities/video-foreground-object-removal.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.