Developer API — Live

Virtual Renovation API

What would this kitchen look like with new cabinets, or this living room with oak floors instead of carpet? The Roomagen Virtual Renovation API answers that from a single photo: it changes the surfaces of the room (walls, flooring, cabinetry, fixtures) and keeps its layout and structure. Store the result next to your original to show before and after.

Get your API key
Virtual Renovation API input
input.jpg
Virtual Renovation API result
✓ result.jpg · 47s

Ejemplo de demostración: la imagen de entrada se creó con IA para este sitio web; no es una foto de un cliente.

Who builds with this endpoint

Contractor quoting tools

Attach a rendered preview to every estimate, so a homeowner sees the proposed kitchen or bath before signing.

Real-estate listing features

Add a "see the potential" toggle to dated listings, showing buyers a renovated version of the same room next to the current photo.

Kitchen and bath retail

Let shoppers preview cabinet styles, countertops and tile in a photo of their own kitchen, moving a showroom decision into your product page.

Home-improvement fintech

Show borrowers what a renovation loan buys — a rendered after-state of their actual home makes the value of financing concrete at application time.

One request, one webhook

Submit a job with the virtual-renovation tool, get a job id, receive a webhook when the result is ready.

POST /api/v1/jobs — virtual-renovation
$ curl -X POST https://api.roomagen.com/api/v1/jobs \
-H "X-Api-Key: rmg_live_..." \
-H "Content-Type: application/json" \
-d '{
"tool": "virtual-renovation",
"image_url": "https://example.com/photo.jpg",
"options": {"style":"modern","roomType":"kitchen"},
"webhook_url": "https://yourapp.com/hooks/roomagen"
}'
# → { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }

Every option of virtual-renovation in the docs → · All documented tools

Prepaid, per image

Developer

$0

50 watermarked images, one time

first key only

Pilot

$125

500 images

$0.25 / image

Buy in the portal

Prepaid · never expires

Most popular

Growth

$550

2,500 images

$0.22 / image

Buy in the portal

Prepaid · never expires

Scale

$2,000

10,000 images

$0.20 / image

Buy in the portal

Prepaid · never expires

Full pricing on the API overview →

Up and running in minutes

Create a key, send one POST, get the finished image back. No sales call, no onboarding queue.

roomagen-api — quickstartv1
  1. 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. 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-renovation",
    "image_url": "https://example.com/photo.jpg",
    "options": { "style": "modern", "roomType": "kitchen" } }'
    # → 201 { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }
  3. 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

Virtual Renovation API FAQ

Previews are concept images: lighting, perspective and room geometry follow the source photo, and materials are rendered to match the style you pick. They communicate design intent — they are not construction drawings and should not replace contractor plans.

It is not meant to. Virtual renovation changes surfaces, fixtures and finishes (flooring, cabinets, countertops, paint, tile) and keeps the room’s layout and structure; structural remodels are outside the scope of the tool. Check each render against the original before you show it.

Not from the API: a completed job returns the rendered preview in result_urls. You already hold the original, so store the two together to build a slider, a toggle or a side-by-side view.

No. The API adds no disclosure label; once your account has bought a pack, renders carry no Roomagen branding either. If renovated images appear in a listing, add the disclosure your MLS or local rules require in your own interface.

Renders typically finish in under a minute. As with every Roomagen tool, the job id returns immediately and a webhook delivers the result, with status polling available for simpler integrations.

Each render draws one image from prepaid packs, two at 4K: 500 at $0.25, 2,500 at $0.22, and 10,000 at $0.20 per image. Your first API key comes with 50 free images, one time and with no card required; they carry a Roomagen watermark until you buy a pack.