Video Background Remover

Playground

WaveSpeed Video Background Remover replaces or removes video backgrounds with a custom image. Upload or paste a link to your video, then provide a background image by URL or file—clean matting, edge-aware blending, and natural compositing keep subjects realistic. Built for creator workflows and batch jobs. Ready-to-use REST inference API with fast response, no cold starts, and predictable pricing.

Features

WaveSpeed Video Background Remover

Video Background Remover is an AI-powered tool that automatically detects and removes backgrounds from videos, with the option to replace them with custom background images. Perfect for content creators, video editors, and marketers who need clean, professional video compositing without manual masking.

Key capabilities

Automatic background detection and removal Intelligently separates foreground subjects from backgrounds in video content without manual masking or green screens.
Custom background replacement Replace the original background with your own image for branded content, virtual backgrounds, or creative compositing.
Transparent background support Generate videos with transparent backgrounds when no replacement image is provided, ready for further editing or overlay.
Production-ready quality High-quality edge detection and matting for professional-looking results suitable for marketing, social media, and presentations.

Parameters and how to use

video: (required): URL of the input video to process
background_image: URL of the replacement background image

How to use

video – (required) Provide the URL of your input video. The video should clearly show the subject you want to keep in the foreground. Best results with videos where the subject is distinct from the background.
background_image – (optional) Provide the URL of an image to use as the new background. If omitted, the output will have a transparent background. The image will be automatically scaled and positioned to fit the video dimensions.

After you finish configuring the parameters, click Run, preview the result, and iterate if needed.

Pricing

Pricing is based on video duration:

Video Duration	Cost per run
≤ 5 seconds	$0.05
10 seconds	$0.10

Rate: $0.01 per second (minimum $0.05 for ≤5s, capped at 600s / $6.00).

Notes

Tips for best results:

Use videos with clear subject-background separation for optimal edge detection
Ensure adequate lighting to help the model distinguish the foreground subject
For replacement backgrounds, use high-resolution images that match or exceed your video resolution
Better to use a landscape video which the ratio is 16:9.

Use cases:

Social Media Content – Create eye-catching videos with branded backgrounds
Product Videos – Showcase products on clean or custom backgrounds
Virtual Presentations – Replace home office backgrounds with professional settings
Green Screen Alternative – Process videos without needing physical green screens

Bria Video Eraser – AI-powered video object removal tool for erasing unwanted elements from videos.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/video-background-remover" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

Parameter	Type	Required	Default	Range	Description
video	string	Yes		-	URL of the input video to process for background removal or replacement
background_image	string	No	-	-	URL of the background image to replace the original video background

Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data.id	string	Unique identifier for the prediction, Task Id
data.model	string	Model ID used for the prediction
data.outputs	array	Array of URLs to the generated content (empty when status is not `completed`)
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.has_nsfw_contents	array	Array of boolean values indicating NSFW detection for each output
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Result Request Parameters

Parameter	Type	Required	Default	Description
id	string	Yes	-	Task ID

Result Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data	object	The prediction data object containing all details
data.id	string	Unique identifier for the prediction, the ID of the prediction to get
data.model	string	Model ID used for the prediction
data.outputs	string	Array of URLs to the generated content (empty when status is not completed).
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Vibevoice Video Eraser