Skip to content

Write HTML. Render video. Built for agents.

docs: say background removal can drop objects a person holds (#6002)

Miguel Ángel8d6ceb735982
diff --git a/docs/guides/remove-background.mdx b/docs/guides/remove-background.mdx
index f763737cac..5210a6d76a 100644
--- a/docs/guides/remove-background.mdx
+++ b/docs/guides/remove-background.mdx
@@ -97,6 +97,8 @@ subject, stable framing, and reasonable contrast from the background.
Use another segmentation or masking tool when:
- the subject is a product, animal, or other object;
+- the person holds something, especially a dark microphone, phone, card, or
+ instrument: the model can drop all or part of it;
- fine hair crosses a busy background;
- frame-to-frame edge stability must meet high-end VFX standards;
- you need the original background reconstructed after removing the person.
@@ -126,6 +128,7 @@ cutout sits directly over its original source and edge color must match; use
| Processing is slow | Check `--info`; CPU processing works but is much slower than an available accelerated provider. |
| The subject has a color halo | Use `--quality best`, especially when layering over the original source. |
| The “background plate” has a hole | Expected: it is inverse alpha, not an inpainted clean plate. |
+| Part of a held object is missing | The model matches people, not what they hold. Use another matting tool for that shot. |
The [CLI reference](/packages/cli#remove-background) lists every flag and
supported input.