Developer API — Live

The Real Estate Image API

Virtual staging, renovation, photo enhancement, day-to-dusk, item removal, floor plans and the rest of the Roomagen toolset: every tool documented, behind one job endpoint and one API key. Async jobs with webhooks, results typically in 20–60 seconds, and no Roomagen branding on the output once your account has bought a pack.

Get your API key
terminal — roomagen api
$ 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/empty-living-room.jpg",
    "options": { "style": "scandinavian", "roomType": "living-room" },
    "webhook_url": "https://yourapp.com/hooks/roomagen"
  }'
 
# → { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }

Real output from the tools behind the API

This before/after pair comes from item removal, the same tool the API runs.

Object removal input
input.jpg
Object removal result
✓ result.jpg · 26s

Demo example: the input image was created with AI for this site; it is not a customer photo.

Explore the API by capability

See every tool in the API docs →

Why teams pick Roomagen

Every tool, one endpoint

Staging, renovation, enhancement, day-to-dusk, removal, exteriors and floor plans all run through POST /v1/jobs, and each tool's options are documented with an example. You switch tools with one parameter.

Floor plans, 2D and 3D

Send a 2D plan, a scan or a phone photo of a hand drawing, and get a furnished or empty 3D render, a cleanly redrawn plan, a colored plan or a top-down marketing image back.

Unbranded once you buy a pack

The 50 free images render with a Roomagen watermark: they are for building and testing. Once your account buys a pack, every new render comes back without Roomagen branding, free images you have left included.

Safe retries

Send an Idempotency-Key header and a repeated request returns the original job: no second charge, no second render.

Failed jobs are refunded

A job that fails during generation is refunded automatically. Webhooks are HMAC-signed, with up to five delivery attempts over about 36 minutes.

Self-serve, real docs

Create a key in the developer portal, no sales call needed. Public docs with cURL, Node.js and Python examples; collect results by webhook or by polling.

Designed to feel familiar

Submit a job, get a job id, receive a webhook when it completes. One image per job: run jobs side by side, up to 60 new jobs per minute per key.

POST /api/v1/jobs
$ 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/empty-living-room.jpg",
    "options": { "style": "scandinavian", "roomType": "living-room" },
    "webhook_url": "https://yourapp.com/hooks/roomagen"
  }'
 
# → { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }

Simple prepaid pricing

Credits are denominated in images. Prepaid, and they never expire. Failed generations are never charged.

No card required

Developer

$0

50 watermarked images, one time

first key only

Get your API key

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

Committed-use discounts

Volume

Custom

50,000+ images

Talk to us

Talk to us

Prices per generated image; a 4K render counts as two. Renders carry no Roomagen branding once the account has bought a pack. 30-day notice before any price change.

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-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. 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}
Get your API keyRead the docs

✓ 50 free images on your first key, watermarked until you buy a pack · no card required

API FAQ

Every tool in the Roomagen web app: virtual staging, emptying and decluttering rooms, interior and exterior renovation, kitchens and bathrooms, photo editing, day to dusk and the floor-plan tools. You choose the tool per job with one parameter. Each tool is documented with its options and an example at developers.roomagen.com/docs/tools, and GET /v1/tools lists every slug your key can call.

Jobs are typically ready in 20–60 seconds; virtual staging and virtual renovation sit toward the upper end. You receive a webhook when a job finishes, or you can poll the job every 2–5 seconds.

Once your account has bought a pack, yes: renders carry no Roomagen branding or watermark, while renders made before that from the 50 free images are watermarked, for building and testing. The API adds neither your logo nor a disclosure label, so add any label your listing rules require in your own pipeline.

A job that fails during generation is refunded automatically, and its error field says why. A completed job is charged once; running it again is a new job.

Prepaid packs denominated in images: 500 images at $0.25, 2,500 at $0.22, 10,000 at $0.20, and negotiated committed-use pricing above 50,000. A 4K render counts as two images. Packs never expire and they stack.

No. A job returns the edited image only: no disclosure label, no record of what changed and no copy of the original. Keep your source photo and label edited images where your MLS or local law requires it; California's AB 723, for example, requires a disclosure statement and a link to the unaltered original.

Embedding Roomagen output in your own product or platform is exactly what the API is for. Proxying the raw API as your own API requires a reseller agreement — contact us.

Yes — creating your first API key adds 50 free images to the account, one time, with no card required. They render with a Roomagen watermark until the account buys a pack, and they cover the full job lifecycle, webhooks included, so you can build and test before you buy.

Building something with property images?

Create a key in the developer portal and put your first job through today. 50 free images to build and test with (watermarked until you buy a pack), no card required.

Get your API key