Furnishing API

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

Generate a furnishing

Request Parameters

string

required

The unique user identifier (UUID)

string

required

URL of the space image to furnish

string

required

The desired furnishing theme. Accepted values: MODERN, SCANDINAVIAN, COASTAL, FARMHOUSE, LUXURY, AMERICAN.

string

required

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

string

The generation mode (optional). Accepted values: “creative” (default), “realist”. - “creative”: Creative furnishing - “realist”: Realistic furnishing

string

Custom prompt for furnishing (optional).

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

string

The unique generation identifier (UUID)

number

The number of photo credits remaining for the user

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

This API allows you to generate variations from a previous result.

Request Parameters

string

required

The unique user identifier (UUID)

string

required

The identifier of the previous generation you want to create a variation of

string

required

The desired furnishing theme. Accepted values: MODERN, SCANDINAVIAN, COASTAL, FARMHOUSE, LUXURY, AMERICAN.

string

required

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

string

The generation mode (optional). Accepted values: “creative” (default), “realist”. - “creative”: Creative furnishing - “realist”: Realistic furnishing

string

Custom prompt for furnishing (optional).

string

Webhook URL for notifications (optional)

Response

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

Request Parameters

string

required

The unique user identifier (UUID)

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.

string

Generation status: “starting”, “in_progress”, “succeeded”, “failed”

array

URLs of the furnished images (only present if status=“succeeded”)

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"]
}

API Documentation

Endpoints

Furnishing API

Furnishing API

Generate a furnishing

Request Parameters

Available values for room_type

Available values for theme

Response

Request Example

Response Example

Generate a variation

Request Parameters

Response

Request Example

Response Example

Retrieve a furnishing

Request Parameters

Response

Request Example

Response Example

​Furnishing API

​Generate a furnishing

​Request Parameters

​Available values for room_type

​Available values for theme

​Response

​Request Example

​Response Example

​Generate a variation

​Request Parameters

​Response

​Request Example

​Response Example

​Retrieve a furnishing

​Request Parameters

​Response

​Request Example

​Response Example

Furnishing API

Generate a furnishing

Request Parameters

Available values for room_type

Available values for theme

Response

Request Example

Response Example

Generate a variation

Request Parameters

Response

Request Example

Response Example

Retrieve a furnishing

Request Parameters

Response

Request Example

Response Example