Product Staging API

Photoroom's Product Staging API places an item into a realistic lifestyle scene, like being held, worn or placed on a table. It runs on Edit With AI: set editWithAI.mode to ai.auto and pass the Product Staging prompt from the docs.

Background generation puts a cut-out product on a new AI background: see Generate Background API. Composition combines several products in one image: see Composition API. Product Staging keeps your product photo and stages it in a lifestyle scene.

Product Staging is included in the Plus API plan, at $100 a month ($0.10 an image), and in Enterprise plans with custom pricing: talk to sales. Each call returns one image. Details are on the pricing page.

Get your API key, then send your photo with editWithAI.mode set to ai.auto and the Product Staging prompt. This example is the one from the docs:

curl --request POST \
  --url https://image-api.photoroom.com/v2/edit \
  --header 'x-api-key: YOUR_API_KEY_HERE' \
  --form imageFile=@/path/to/image.png \
  --form removeBackground=false \
  --form editWithAI.mode=ai.auto \
  --form editWithAI.prompt='Make it a professional lifestyle photoshoot with the provided object or subject as the focus of the scene. Ensure the image highlights what is unique about the object, with the goal of advertising it and showing how it impacts everyday life. The lighting should be perfectly set to create a natural and elegant atmosphere. The image should feature excellent composition and a refined mood, achieving the look of high-end lifestyle photography. Integrate a human presence or a subtle interaction with the object to enhance authenticity and visual appeal.' \
  --form editWithAI.seed=2016886668 \
  --output result-product-staging.png

Set editWithAI.seed to any positive integer to get similar-looking results when you reprocess the same photo. Every parameter is in the Edit With AI docs.

Yes. Add up to four reference images with editWithAI.additionalImages, as files or URLs, for five images per request in total. The docs show how to place a product from the main image into the scene of a reference image.

Send PNG, JPEG, WEBP or AVIF files up to 30 MB and up to 5,000 px on the widest side. Staged images come back at 1K (1024 x 1024); for 2K or 4K output, talk to sales.

Run calls in parallel, one image per call, up to 60 images a minute by default. For higher limits on high-volume catalogs, talk to sales.

Check that results stay similar when you reprocess the same photo, that you can steer the scene with your own references, and that one integration covers your other edits too. With Photoroom, that's editWithAI.seed, up to four reference images and 20+ edits from one API.

Yes. Photoroom has an MCP server for AI assistants such as Claude, and it covers Product Staging: see Photoroom MCP for more information.

Having trouble with the API? Join our API community to get help from our engineers, or check the troubleshooting page for common issues.

For anything billing-related or with sensitive information, please DM Photoroom directly in the community. We're always happy to help.

Enterprise teams can also contact sales.