Versely has two distinct background-removal paths for video, and picking the right one matters. remove_video_background is a deterministic FFmpeg colorkey filter — fast, but it ONLY works on a solid pure-black (or near-black) backdrop, the kind you get from a black-matte AI render or footage shot against a black backdrop.
remove_background is the AI-model path for other backgrounds — pass your clip as video_url and pick a model. Neither tool handles green-screen, blue-screen, white, or general photographic/room backgrounds via the colorkey path — for those, remove_background's models are the option, not colorkey.
Powered by
Remove a PURE-BLACK background from a video using FFmpeg colorkey. The video's background must be solid pure-black (or near-black) — typically AI-generated talking-head clips, after-effects renders with a black matte, or footage shot against a black backdrop. Does NOT work for: green-screen, blue-screen, white, or any non-black background — that needs a different filter we don't currently support. Does NOT work for photographic / room / outdoor backgrounds either — that needs a segmentation model we don't expose. ASK THE USER FIRST whether they want the background removed, and CONFIRM the background is black. If they say it's a different color or a real scene, tell them this tool only works for black and we don't support other backgrounds yet.
What to tell the agent
Versely's agent maps this plain-English request directly onto remove_video_background. You don't need to know the parameter names — just describe what you want.
“This video has a solid black background — remove it with colorkey and give me a transparent version.”
How it works
1. Confirm the background type
Is it solid pure-black? Use remove_video_background (fast, deterministic FFmpeg colorkey). Anything else — a room, an outdoor scene, a non-black color — needs the AI-model path via remove_background instead.
2a. For black backgrounds: tune the key
key_similarity and key_blend control how aggressively the colorkey filter treats near-black pixels as background — adjust if edges look ragged.
2b. For other backgrounds: pick a model
remove_background takes a model parameter for the AI-driven removal path when the backdrop isn't solid black.
3. Optionally composite a new background
remove_video_background accepts a background_image_url to composite a new backdrop in directly, rather than leaving it transparent.
4. Render
Get back a video with the background removed (or swapped) as an MP4.
What it costs
The colorkey path (remove_video_background) is a deterministic FFmpeg operation, priced as a standard editor operation. The AI-model path (remove_background) is billed per the selected model. Confirm either with estimate_cost before running.
The formula behind that number: What does editing a video cost if I keep changing it? — charges per finished export, so iteration is free and the count is the whole bill.
Limits & things to know
- remove_video_background ONLY works on solid pure-black or near-black backdrops — it explicitly does not support green-screen, blue-screen, white, or photographic/room backgrounds.
- Always confirm the actual background color before choosing colorkey — the agent should ask if it's unsure, since colorkey run on the wrong background produces a broken result.
- For non-black backgrounds, remove_background's model-based path is the fallback, not a different colorkey setting.
Who uses this
- Cutting out an AI-generated talking-head clip rendered on a black matte
- Removing a solid black studio backdrop
- Isolating a subject shot against a non-black background via the AI model path
Frequently asked questions
Does colorkey work on green screen?+
No — remove_video_background's colorkey filter only supports pure-black or near-black backgrounds. Green-screen, blue-screen, white, and general photographic backgrounds aren't supported by that tool.
What do I use for a non-black background?+
remove_background, which takes an AI model as its removal mechanism rather than a deterministic color filter.
Can I replace the background instead of just removing it?+
Yes — remove_video_background accepts a background_image_url to composite a new backdrop directly during the colorkey pass.
Related Versely tools
Related editing jobs
Remove a Video's Background inside Versely
The all-in-one AI studio for creators. 60+ models for video, image, voice, music and lipsync in a single app.