​
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/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: STANDARD, MODERN, SCANDINAVIAN, INDUSTRIAL, COASTAL, FARMHOUSE, LUXURY, AMERICAN.

​
room_type
string
required

The type of room to furnish. Accepted values: LIVING_ROOM, BEDROOM, DINING, HOME_OFFICE, KIDS, OUTDOOR.

​
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:

  • STANDARD - Standard style
  • MODERN - Modern style
  • SCANDINAVIAN - Scandinavian style
  • INDUSTRIAL - Industrial 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/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/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: STANDARD, MODERN, SCANDINAVIAN, INDUSTRIAL, COASTAL, FARMHOUSE, LUXURY, AMERICAN.

​
room_type
string
required

The type of room to furnish. Accepted values: LIVING_ROOM, BEDROOM, DINING, HOME_OFFICE, KIDS, OUTDOOR.

​
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/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/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/generate or /api/furnish/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/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"]
}