​
Renovation API

The renovation service allows you to visualize how a space might appear after renovation work, without performing the actual renovations.

​
Generate a renovation

​
POST /api/renovate/generate

​
Request Parameters

​
user_id
string
required
The unique user identifier (UUID)
​
image_url
string
required
URL of the image of the space to be renovated
​
theme
string
required
The desired decoration theme for the renovation. Accepted values: MODERN, SCANDINAVIAN, INDUSTRIAL, LUXURIOUS, FARMHOUSE_CHIC, KIDS_ROOM (for BEDROOM only), MODERN_POP (for LIVING_ROOM and VERANDA only).
​
room_type
string
required
The room type. Accepted values: LIVING_ROOM, BEDROOM, BATHROOM, SHOWEROOM, HOME_OFFICE, EMPTY, VERANDA, KITCHEN, DINING_ROOM.
​
photo_360
boolean
If the image is a 360° panoramic photo
​
keep_ceiling
boolean
Preserve the original ceiling
​
keep_floor
boolean
Preserve the original floor
​
keep_wall
boolean
Preserve the original walls
​
keep_door
boolean
Preserve the original doors
​
keep_window
boolean
Preserve the original windows (enabled by default)
​
furnish
boolean
Furnish the renovated room. Works only with: BEDROOM, DINING_ROOM, LIVING_ROOM, HOME_OFFICE.
​
webhook
string
Webhook URL for notifications (optional)

​
Available values for room_type

The following values are accepted for the room_type parameter:
  • LIVING_ROOM - Living room
  • BEDROOM - Bedroom
  • BATHROOM - Bathroom
  • SHOWEROOM - Shower room
  • HOME_OFFICE - Home office
  • EMPTY - Empty room
  • VERANDA - Veranda
  • KITCHEN - Kitchen
  • DINING_ROOM - Dining room

​
Available values for theme

The following values are accepted for the theme parameter (note that not all themes are available for all room types):
  • MODERN - Modern style
  • SCANDINAVIAN - Scandinavian style
  • INDUSTRIAL - Industrial style
  • LUXURIOUS - Luxurious style
  • FARMHOUSE_CHIC - Farmhouse/rustic style
  • KIDS_ROOM - Kids room (for BEDROOM type only)
  • MODERN_POP - Colorful modern style (only for LIVING_ROOM and VERANDA)

​
Rooms compatible with the furnish option

The furnish option works only with the following room types:
  • BEDROOM
  • DINING_ROOM
  • LIVING_ROOM
  • HOME_OFFICE

​
Response

​
generation_id
string
The unique generation identifier (UUID)
​
remaining_photos
number
The number of photo credits remaining for the user
​
project_id
string
The unique project identifier (UUID)

​
Request Example

curl -X POST https://api.iacrea.ai/api/renovate/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "123e4567-e89b-12d3-a456-426614174000",
    "image_url": "https://example.com/kitchen-before.jpg",
    "theme": "MODERN",
    "room_type": "KITCHEN",
    "photo_360": false,
    "keep_ceiling": false,
    "keep_floor": false,
    "keep_wall": false,
    "keep_door": true,
    "keep_window": true,
    "furnish": true
  }'

​
Response Example

{
  "generation_id": "123e4567-e89b-12d3-a456-426614174001",
  "remaining_photos": 6,
  "project_id": "123e4567-e89b-12d3-a456-426614174002"
}

​
Generate a variation

​
POST /api/renovate/generate-variation
This API allows you to generate variations from a previous result.

​
Request Parameters

​
user_id
string
required
The unique user identifier (UUID)
​
generation_id
string
required
The identifier of the previous generation you want to create a variation of
​
theme
string
required
The new desired decoration theme. Accepted values: MODERN, SCANDINAVIAN, INDUSTRIAL, LUXURIOUS, FARMHOUSE_CHIC, KIDS_ROOM (for BEDROOM only), MODERN_POP (for LIVING_ROOM and VERANDA only).
​
room_type
string
required
The room type. Accepted values: LIVING_ROOM, BEDROOM, BATHROOM, SHOWEROOM, HOME_OFFICE, EMPTY, VERANDA, KITCHEN, DINING_ROOM.
​
photo_360
boolean
If the image is a 360° panoramic photo
​
keep_ceiling
boolean
Preserve the original ceiling
​
keep_floor
boolean
Preserve the original floor
​
keep_wall
boolean
Preserve the original walls
​
keep_door
boolean
Preserve the original doors
​
keep_window
boolean
Preserve the original windows (enabled by default)
​
furnish
boolean
Furnish the renovated room. Works only with: BEDROOM, DINING_ROOM, LIVING_ROOM, HOME_OFFICE.
​
webhook
string
Webhook URL for notifications (optional)

​
Response