Virtual Staging API
Furnish an empty room with a single POST request. The Roomagen Virtual Staging API takes a photo of a vacant space and returns it fully furnished in your chosen style — walls, windows and flooring untouched. Results arrive by webhook in 10–30 seconds, white-label by default.


Who builds with this endpoint
Real-estate listing platforms
Stage every vacant listing automatically at upload time, so agents publish furnished photos without opening an editor or waiting on a design vendor.
Furniture e-commerce
Let shoppers see furniture in a room instead of a white void — render styled scenes from product-page photos to lift engagement and reduce returns.
Short-term-rental management
Refresh Airbnb and Vrbo listing photos across an entire managed portfolio in one batch, keeping every unit market-ready between guest turnovers.
Interior-design apps
Give users an instant "what could this room become" moment: they photograph their space, your app calls the API, and a styled concept comes back in seconds.
One request, one webhook
Submit a job with the virtual-staging tool, get a job id, receive a webhook when the result is ready.
$ curl -X POST https://api.roomagen.com/api/v1/jobs \-H "X-Api-Key: rmg_live_..." \-H "Content-Type: application/json" \-d '{"tool": "virtual-staging","image_url": "https://example.com/photo.jpg","options": {"style":"scandinavian","roomType":"living-room"},"webhook_url": "https://yourapp.com/hooks/roomagen"}'# → { "job_id": "job_8f3a...", "status": "processing" }
Prepaid, per image
Up and running in minutes
Create a key, send one POST, get the finished image back. No sales call, no onboarding queue.
- 1
Create your key
Sign in to the developer portal and generate a key. It is shown once, so store it somewhere safe.
developers.roomagen.com/portal ↗ - 2
Run your first job
One POST with a tool slug and your image. It returns immediately with a job id — generation runs in the background.
$ curl -X POST https://api.roomagen.com/api/v1/jobs \-H "X-Api-Key: rmg_live_..." \-H "Content-Type: application/json" \-d '{ "tool": "virtual-staging","image_url": "https://example.com/photo.jpg","options": { "style": "scandinavian", "roomType": "living-room" } }'# → 201 { "job_id": "job_8f3a...", "status": "processing" } - 3
Get the result
Set a webhook_url and we call you when the image is ready, or poll the job endpoint. Typically 20–60 seconds.
POST → your webhook_urlGET /api/v1/jobs/{id}
✓ 50 free images on your first key · no card required