Remove Video Background
remove_video_backgroundRemove or replace a video background with transparency, a solid color, or a custom image; process via file upload or public URL and retrieve results asynchronously.
Instructions
This tool will remove or replace the background of a video, producing a transparent, solid-color, or custom-image background. This is an asynchronous operation and spends credits; use get_job_status with the returned job_id to retrieve the result. It takes the following arguments: - media_file or video_url (one required): The video to process, either an uploaded file or a public URL that links directly to a real video file (not a web page). - output_transparent (bool, optional): Make the background transparent. Defaults to true unless a color or image background is given. - background_color (str, optional): Hex color to fill the background with. - background_image_url (str, optional): Public URL of an image to use as the new background. - duration_seconds (number, optional): Informational only; the server measures the real length (max 3600s) to price the job. - is_watermark (bool, optional): Defaults to true. Watermark-free exports cost double for accounts that have never purchased credits.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "remove_video_background"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| video_url | No | Public URL of the video to process. Use this or media_file. | |
| media_file | No | Base64-encoded video or video data URI. Use this or video_url. | |
| is_watermark | No | Whether the output carries the BGRemover watermark. Defaults to true. Watermark-free exports cost double for accounts that have never purchased credits. | |
| background_color | No | Hex color (e.g. '#00ff00') to fill the background with instead of transparency. | |
| duration_seconds | No | Optional and informational only: the server always measures the real video length (max 3600s), which determines the credit cost. | |
| output_transparent | No | If true, the removed background becomes transparent. Defaults to true unless background_color or background_image_url is given. | |
| background_image_url | No | Public URL of an image to use as the new background. Takes precedence over background_color. |