RoomagenDevelopersGet API key

Guide

Interior renovation

Walls, floors, surfaces, fireplaces, railings, fans, lights, doors, and finishing a raw interior.

Each tool on this page changes one element of a room photo — the walls, the floor, a surface, the fireplace, the railing, the fan, the lights or the doors — and asks for everything else to stay exactly as photographed. They suit a contractor quoting a job, a designer comparing finishes, or a seller showing what a dated room could become. Each costs one image per render.

Most of them also take your own words: with tier: "custom", customPrompt describes the change (up to 500 characters) and replaces the options. The line under each heading says whether a tool does. To restyle a whole room at once, use virtual renovation.

Wall color change

wall-color-change1 image per renderno custom prompt — customPrompt is ignored

Repaints every visible wall in one colour and sheen, keeping the wall's texture and the light falling on it.

OptionTypeValuesDefaultRequiredDescription
colorstring—#FFFFFFoptional

Paint colour for every visible wall, as a hex code #RRGGBB. Checked in the guided tier.

finishstring
matteeggshellsatinsemi-gloss
eggshelloptional

Sheen of the paint.

json
{
  "tool": "wall-color-change",
  "image_url": "https://example.com/living-room.jpg",
  "options": {
    "color": "#C9D6C4",
    "finish": "matte"
  }
}

color is a hex code, #RRGGBB; the default guided tier rejects anything else with invalid_request.

Wall treatment

wall-treatment1 image per renderreads customPrompt with tier custom

Paint, wallpaper, stone cladding, exposed brick, wood panelling or tile on the walls. Cabinets, the backsplash, appliances and furniture are not walls and stay as they are.

OptionTypeValuesDefaultRequiredDescription
wallTreatmentstring
paintwallpaperstone-claddingbrickwood-paneltile
paintoptional

What goes on the walls.

targetColorstring—#E8E4DEoptional

Paint colour as a hex code #RRGGBB; for wallpaper, the colour its tones follow.

wallTonestring——optional

Free text for the shade or pattern ("warm-grey", "botanical"); hyphens read as spaces. Used by every treatment except paint.

wallpaperStylestring——optional

Where wallpaper goes: full-wall (when omitted), accent-wall (one wall, the others painted in targetColor), chair-rail, wainscoting or panel-molding.

panelColorstring——optional

Free text for the wainscoting's finish, with wallpaperStyle wainscoting.

json
{
  "tool": "wall-treatment",
  "image_url": "https://example.com/bedroom.jpg",
  "options": {
    "wallTreatment": "wallpaper",
    "wallTone": "botanical",
    "wallpaperStyle": "accent-wall",
    "targetColor": "#DCE3D5"
  }
}

Flooring replacement

flooring-replacement1 image per renderreads customPrompt with tier custom

Swaps the hard floor for a new material laid in a sensible direction. Rugs and mats are objects on the floor, not the floor, so they stay — and so does everything standing on it.

OptionTypeValuesDefaultRequiredDescription
floorTypestring
hardwoodtilecarpetvinylmarblelaminateconcrete
hardwoodoptional

The new floor material. Rugs on the floor are kept.

floorTonestring——optional

Free text for the variety or shade ("walnut", "light-grey", "carrara white"); hyphens read as spaces.

json
{
  "tool": "flooring-replacement",
  "image_url": "https://example.com/dining-room.jpg",
  "options": {
    "floorType": "hardwood",
    "floorTone": "light-oak"
  }
}

Restyle surfaces

restyle-surfaces1 image per renderreads customPrompt with tier custom

Gives one surface a new material: the countertop, the backsplash, the wall tile or the floor. For more choice on a single surface, countertop replacement, backsplash update and flooring replacement have longer material lists.

OptionTypeValuesDefaultRequiredDescription
surfaceTypestring
countertopbacksplashwall-tilefloor
countertopoptional

The one surface that changes.

materialstring
marblegranitequartzceramic-tilesubway-tilewoodconcrete
marbleoptional

Its new material.

json
{
  "tool": "restyle-surfaces",
  "image_url": "https://example.com/kitchen.jpg",
  "options": {
    "surfaceType": "countertop",
    "material": "granite"
  }
}

Fireplace renovation

fireplace-renovation1 image per renderreads customPrompt with tier custom

Redesigns the fireplace — the kind of firebox, its overall style and the material around it — and leaves the rest of the room alone.

OptionTypeValuesDefaultRequiredDescription
fireplaceTypestring
wood-burninggas-insertelectricethanol
gas-insertoptional

The kind of firebox.

fireplaceStylestring
modern-lineartraditional-mantelrustic-stoneminimalist-framelessfarmhouse
modern-linearoptional

Overall design of the fireplace.

surroundMaterialstring
marblestonebricktilewoodconcretemetal
marbleoptional

Material of the surround.

json
{
  "tool": "fireplace-renovation",
  "image_url": "https://example.com/living-room-fireplace.jpg",
  "options": {
    "fireplaceType": "gas-insert",
    "fireplaceStyle": "minimalist-frameless",
    "surroundMaterial": "concrete"
  }
}

Staircase railing

staircase-railing1 image per renderreads customPrompt with tier custom

Replaces the railing on the stairs — balusters, handrail and newel posts — and keeps the steps themselves and the walls around them.

OptionTypeValuesDefaultRequiredDescription
railingTypestring
metal-balustersglass-panelcable-railwood-spindleshorizontal-barswrought-iron
metal-balustersoptional

The new railing.

railingFinishstring
matte-blackbrushed-nickelchromewood-naturalwood-darkwhite-painted
matte-blackoptional

Its finish.

json
{
  "tool": "staircase-railing",
  "image_url": "https://example.com/hallway-stairs.jpg",
  "options": {
    "railingType": "glass-panel",
    "railingFinish": "brushed-nickel"
  }
}

Ceiling fan

ceiling-fan1 image per renderreads customPrompt with tier custom

Installs a ceiling fan at the centre of the ceiling, or where a fan or light fixture already hangs.

OptionTypeValuesDefaultRequiredDescription
fanStylestring
modern-flushtraditionalindustrialtropicalbladelessfarmhouse
modern-flushoptional

Style of the fan that is added or replaced.

fanFinishstring
matte-blackbrushed-nickelwhitewoodbronzechrome
matte-blackoptional

Its finish.

bladeCountstring
3-blade4-blade5-blade
3-bladeoptional

Number of blades.

json
{
  "tool": "ceiling-fan",
  "image_url": "https://example.com/bedroom.jpg",
  "options": {
    "fanStyle": "industrial",
    "fanFinish": "bronze",
    "bladeCount": "5-blade"
  }
}

Lighting update

lighting-update1 image per renderreads customPrompt with tier custom

Replaces the light fixtures already in the photo with pendants, recessed lights, a chandelier, wall sconces, a vanity light, track lighting or flush mounts. It is told not to add lights where the photo has none, with a customPrompt too.

OptionTypeValuesDefaultRequiredDescription
lightingTypestring
pendantrecessedchandelierwall-sconcevanity-lighttrack-lightingflush-mount
pendantoptional

The fixture type that replaces the fixtures already in the photo. The tool is told not to add lights the photo does not have, with a customPrompt too.

lightingStylestring
modernindustrialtraditionalminimalistfarmhousemid-century
modernoptional

Their style.

lightingFinishstring——optional

Free text for the fixture finish ("brass", "matte-black"); hyphens read as spaces.

json
{
  "tool": "lighting-update",
  "image_url": "https://example.com/kitchen-island.jpg",
  "options": {
    "lightingType": "pendant",
    "lightingStyle": "industrial",
    "lightingFinish": "brass"
  }
}

Door update

door-update1 image per renderreads customPrompt with tier custom

Changes the style and the finish of a door — interior, front, closet, French, barn or sliding.

OptionTypeValuesDefaultRequiredDescription
doorTypestring
interiorfront-doorcloset-doorsfrench-doorsbarn-doorsliding
interioroptional

Which doors change, and what they become.

doorStylestring
modern-flatpaneledglass-insertshakercraftsman
modern-flatoptional

Door design.

doorTonestring——optional

Free text for the colour or wood ("white", "natural-oak"); hyphens read as spaces.

json
{
  "tool": "door-update",
  "image_url": "https://example.com/entrance.jpg",
  "options": {
    "doorType": "front-door",
    "doorStyle": "craftsman",
    "doorTone": "natural-oak"
  }
}

Construction interior

construction-interior1 image per renderno custom prompt — customPrompt is ignored

Shows a raw, under-construction room finished and furnished: plastered and painted walls, a finished floor and ceiling, glazed frames, the debris and tools gone. The room's dimensions, openings and the camera stay exactly as photographed. Property developers use it to market a building before it is finished.

OptionTypeValuesDefaultRequiredDescription
roomTypestring
living-roombedroomkitchendining-roombathroomhome-officekids-roomstudiohallwayentrywaylaundrydressing-roomgaragebalconyterrace
living-roomoptional

What the finished room is.

stylestring
modernscandinavianindustrialtraditionalminimalistbohemianmid-century-moderncoastalfarmhouseluxuryjapandiart-decomediterranean
modernoptional

Interior style of the finishes and furniture.

furniturestring——optional

Optional comma-separated furniture ids for the roomType, such as sofa,coffee-table,rug for a living-room; ids the room type does not have are skipped. Omitted, the room is furnished to suit its type.

json
{
  "tool": "construction-interior",
  "image_url": "https://example.com/concrete-shell.jpg",
  "options": {
    "roomType": "bedroom",
    "style": "japandi"
  }
}

Using your own words

Every tool above except wall color change and construction interior takes a custom prompt. Set tier to custom and describe the change; the options are then not checked.

json
{
  "tool": "flooring-replacement",
  "image_url": "https://example.com/dining-room.jpg",
  "options": {
    "tier": "custom",
    "customPrompt": "Wide-plank smoked oak laid in a herringbone pattern, matte finish"
  }
}

Next steps