Exterior AI

1 tokenExterior

Transform home exteriors with AI

Overview

Exterior AI redesigns the outside of buildings — houses, villas, apartments, commercial properties, and more. Upload a photo of any building exterior and the AI will reimagine it in your chosen architectural style while preserving the building structure. Perfect for architects, home builders, and property developers exploring facade design options.

Image input

Endpoint

POST /api/v1/generate

bash

curl -X POST https://roomai.com/api/v1/generate \
  -H "Authorization: Bearer rai_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"model": "exterior", ...}'

Parameters

Parameter	Type	Required	Description
`model`	string	Required	Must be "exterior". exterior
`image`	string	Required	URL of the building exterior photo.
`knows`	string	Optional	Building type for contextual design. House ExteriorModern HouseTraditional HouseLuxury VillaEco-Friendly HouseUrban Residence
`styles`	string	Optional	Design style to apply. Over 99 styles available including modern, minimalist, industrial, and more. ModernMinimalistScandinavianIndustrialMid-Century ModernBohemian
`prompt`	string	Optional	Custom text instructions describing the desired output.
`precise`	string	Optional	AI strength from "0" to "100". Lower values give the AI more creative freedom. Higher values preserve more of the original structure. Default: `"50"`
`style_transfer`	string	Optional	URL of a reference image whose style should be matched in the output.
`enhance_prompt`	string	Optional	Set to "true" to let the AI enhance and expand your prompt for better results. Default: `"false"` truefalse
`luwmodel`	string	Optional	AI model variant to use. Default: `"symphony-3"` symphony-3aria
`format`	string	Optional	Output image format. Default: `"png"` png
`seed`	number	Optional	Random seed for reproducible results. Using the same seed with the same parameters produces identical output.

Request Example

json

{
  "model": "exterior",
  "image": "https://example.com/house-front.jpg",
  "styles": "modern",
  "knows": "House Exterior",
  "prompt": "contemporary facade with large windows and clean lines"
}

Response

Success (200)

json

{
  "status": "success",
  "result": {
    "image_url": "https://storage.googleapis.com/...",
    "model": "exterior",
    "tokens_used": 1,
    "processing_time_ms": 4500
  }
}

Error

json

{
  "status": "error",
  "error": {
    "code": "INSUFFICIENT_TOKENS",
    "message": "Not enough tokens",
    "required": 1,
    "balance": 0
  }
}

Code Examples

cURL

bash

curl -X POST https://roomai.com/api/v1/generate \
  -H "Authorization: Bearer rai_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "exterior",
  "image": "https://example.com/house-front.jpg",
  "styles": "modern",
  "knows": "House Exterior",
  "prompt": "contemporary facade with large windows and clean lines"
}'

JavaScript / Node.js

javascript

const response = await fetch("https://roomai.com/api/v1/generate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer rai_live_your_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "exterior",
  "image": "https://example.com/house-front.jpg",
  "styles": "modern",
  "knows": "House Exterior",
  "prompt": "contemporary facade with large windows and clean lines"
}),
});

const data = await response.json();

if (data.status === "success") {
  console.log("Image URL:", data.result.image_url);
  console.log("Tokens used:", data.result.tokens_used);
} else {
  console.error("Error:", data.error.message);
}

Python

python

import requests

response = requests.post(
    "https://roomai.com/api/v1/generate",
    headers={
        "Authorization": "Bearer rai_live_your_api_key",
        "Content-Type": "application/json",
    },
    json={
  "model": "exterior",
  "image": "https://example.com/house-front.jpg",
  "styles": "modern",
  "knows": "House Exterior",
  "prompt": "contemporary facade with large windows and clean lines"
},
)

data = response.json()

if data["status"] == "success":
    print("Image URL:", data["result"]["image_url"])
    print("Tokens used:", data["result"]["tokens_used"])
else:
    print("Error:", data["error"]["message"])

Tips

1Use "knows" to specify the building type — the AI designs differently for a villa vs. an office building.
2Front-facing photos with good lighting produce the best results.
3Try the "Eco-friendly" or "Biophilic" styles for sustainable architecture designs.
4Set "precise" higher (70+) to keep the building structure unchanged and only modify surface materials and landscaping.