Skip to main content

​
Furnishing API

The furnishing service allows you to virtually furnish empty spaces or replace existing furniture in your images.

​
Generate a furnishing

​
POST /api/furnish/v4/generate

​
Request Parameters

​
user_id
string
required
The unique user identifier (UUID)
​
image_url
string
required
URL of the space image to furnish
​
theme
string
required
The desired furnishing theme. Accepted values: MODERN, SCANDINAVIAN, COASTAL, FARMHOUSE, LUXURY, AMERICAN.
​
room_type
string
required
The type of room to furnish. Accepted values: LIVING_ROOM, BEDROOM, DINING, HOME_OFFICE, KIDS, OUTDOOR.
​
generation_mode
string
The generation mode (optional). Accepted values: “creative” (default), “realist”. - “creative”: Creative furnishing - “realist”: Realistic furnishing
​
prompt
string
Custom prompt for furnishing (optional).
​
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
  • DINING - Dining room
  • HOME_OFFICE - Home office
  • KIDS - Kids room
  • OUTDOOR - Outdoor space

​
Available values for theme

The following values are accepted for the theme parameter:
  • MODERN - Modern style
  • SCANDINAVIAN - Scandinavian style
  • COASTAL - Coastal style
  • FARMHOUSE - Farmhouse style
  • LUXURY - Luxury style
  • AMERICAN - American style

​
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/furnish/v4/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/empty-space.jpg",
    "theme": "MODERN",
    "room_type": "LIVING_ROOM"
  }'

​
Response Example

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

​
Generate a variation

​
POST /api/furnish/v4/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 desired furnishing theme. Accepted values: MODERN, SCANDINAVIAN, COASTAL, FARMHOUSE, LUXURY, AMERICAN.
​
room_type
string
required
The type of room to furnish. Accepted values: LIVING_ROOM, BEDROOM, DINING, HOME_OFFICE, KIDS, OUTDOOR.
​
generation_mode
string
The generation mode (optional). Accepted values: “creative” (default), “realist”. - “creative”: Creative furnishing - “realist”: Realistic furnishing
​
prompt
string
Custom prompt for furnishing (optional).
​
webhook
string
Webhook URL for notifications (optional)

​
Response

​
generation_id
string
The unique identifier of the new generation (UUID)

​
Request Example

curl -X POST https://api.iacrea.ai/api/furnish/v4/generate-variation \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "123e4567-e89b-12d3-a456-426614174000",
    "generation_id": "123e4567-e89b-12d3-a456-426614174001",
    "theme": "SCANDINAVIAN",
    "room_type": "LIVING_ROOM"
  }'

​
Response Example

{
  "generation_id": "123e4567-e89b-12d3-a456-426614174003"
}

​
Retrieve a furnishing

​
POST /api/furnish/v4/get

​
Request Parameters

​
user_id
string
required
The unique user identifier (UUID)
​
generation_id
string
required
The unique generation identifier (UUID) returned by the /api/furnish/v4/generate or /api/furnish/v4/generate-variation endpoint

​
Response

The endpoint returns the generation status and the URLs of the resulting images when processing is complete.
​
status
string
Generation status: “starting”, “in_progress”, “succeeded”, “failed”
​
urls
array
URLs of the furnished images (only present if status=“succeeded”)
​
variationNumber
number
Variation number (optional)

​
Request Example

curl -X POST https://api.iacrea.ai/api/furnish/v4/get \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "123e4567-e89b-12d3-a456-426614174000",
    "generation_id": "123e4567-e89b-12d3-a456-426614174001"
  }'

​
Response Example

{
  "status": "succeeded",
  "urls": ["https://example.com/furnished-space.jpg"]
}