​
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