Remove or replace
Remove places the subject on white. Replace puts the subject over a solid colour (hex) or a replacement image. If you don't pass a background, the background is removed.
CatalogLatency Async; completion time depends on video length and resolution Async true Rate Limit Per API key Max Input Standard video resolutions and lengths
cn8/studio-background
Send a video URL and choose a background. The subject is cut out from every frame —
Learn more about Background Remove / Replace Videoasync (job)Instant previewvideoprocessingstudio
Try it
Source video
New background
#10b981Result
The result shows up here
Upload your video on the left and hit Run.
Overview
Send a video URL and choose a background. The subject is cut out from every frame — with refined edges and fine detail like hair — and composited over the base you pick: white (remove), a solid hex colour (e.g. #1E90FF), or a replacement image. The original audio is kept, and the result is delivered as an MP4 at the source resolution. You can optionally trim the video (start/end) so only the part you need is processed. This is an async job: submit it, poll until it's ready, then download the result.
Key capabilities
Clean per-frame cutouts
Every frame is cut out separately with refined edges and fine detail like hair, then composited over your chosen base at the original resolution — so motion stays sharp and consistent.
Optional trim
Pass start and end (seconds or hh:mm:ss) to process only part of the video first. This shortens the output and lowers the cost.
Audio preserved
The original audio track is kept in the result. Output is a single MP4.
When to use it
Virtual backgrounds
Replace the background with a solid colour or image for calls, presentations, or thumbnails.
Product or talking-head clips
Put a clean subject over white or a custom background; trim to process only the part you need.
Input & output
input
Source video (URL or asset ID), optional background (hex colour or replacement image URL/asset), optional start/end for trim
JSON body
output
Job ID; when completed, the result includes the output video URL (MP4)
JSONmedia URL
Guides & tips
How it works
- Submit a video URL and choose a background (white, a hex colour, or a replacement image).
- Each frame is cut out separately with refined edges and fine detail like hair, then composited over the base. The original audio is kept and the result is delivered as a single MP4 at the source resolution.
- Because it runs frame by frame on a full video, this is an async job — submit it, poll until it's ready, then download the result.
When to use trim
- Pass start/end when you only need part of the video processed (e.g. the first 30 seconds). This shortens the output and lowers the billed seconds.
Specs
Schema
Request body
videoUrlrequiredstringDirect URL of the source video (e.g. an upload-media public_url).
back_groundstringHex colour for a solid replacement (e.g. "#1E90FF"). Omit to remove the background (subject on white), or use imageUrl for an image.
imageUrlstringURL of a replacement background image. Takes precedence if both back_ground and imageUrl are set.
startstring|numberOptional trim start: seconds (number) or "hh:mm:ss".
endstring|numberOptional trim end: seconds (number) or "hh:mm:ss".
Pricing
Billed per second of source video (the trimmed segment if start/end are provided). Two-part tariff: 8 credits base fee per job + 6 credits/second, minimum 5 billed seconds. Failed jobs are not billed.
| Service | Unit | Price |
|---|---|---|
| Background Remove/Replace | second | 6 credits/second |
Trimming with start/end shortens the segment and lowers the billed duration.