background-replacement-sceneslisted

# Background Replacement `replace_background` swaps the scene **and relights the subject to match it**, for 3 credits. That relighting is the whole point — it's what separates a plausible composite from a cutout pasted on a photo. It's the fastest way to turn one product shot into ten contexts. ## The call ``` replace_background( image="<product photo or cutout>", prompt="Pale oak kitchen counter, soft morning light from a window " "on the left, blurred kitchen behind, warm neutral grade, " "shallow depth of field" ) → product on the new scene, relit ``` 3 credits. Describe the **scene and the light**, not the product — the product comes from the input image. ## Why the relighting matters A naive composite fails in a specific, recognisable way: the product's lighting doesn't match the scene's. Sun coming from the right, product lit from the left, no contact shadow, hard edges. Everyone reads it as fake without being able to say why. `replace_background` handles the light direction, the colour temperature and the contact shadow together. That's the difference between an asset you can put on a listing and one that looks like a mistake. | | Manual composite | `replace_background` | |---|---|---| | Light direction | Mismatched unless you fix it | Matched | | Colour temperature | Mismatched | Matched | | Contact shadow | You add one, approximately | Generated plausibly | | Edge integration | Hard, obvious | Softer | | Cost | Editor time | 3 credits |