Virtual Staging API
Furnish an empty room with a single POST request. The Roomagen Virtual Staging API reads the geometry and light in a photo of a vacant space and places furniture in the style you ask for, keeping the existing wall and floor finishes unless you ask for new ones. Most jobs finish in under a minute, and once your account has bought a pack, the result carries no Roomagen branding.
Who builds with this endpoint
Real-estate listing platforms
Stage vacant listings at upload time, so agents get furnished photos without opening an editor or waiting on a design vendor.
Furniture e-commerce
Show a collection’s look in a real room instead of a white void: stage empty-room photos in a matching style, or set furnitureMode to manual and name the pieces.
Short-term-rental management
Show owners how an empty unit could be furnished before they buy anything, staging photos across a managed portfolio from one script.
Interior-design apps
Give users a "what could this room become" moment: they photograph their space, your app calls the API, and a styled concept comes back in under a minute.
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": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }
Every option of virtual-staging in the docs → · All documented tools
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": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] } - 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, watermarked until you buy a pack · no card required