Exterior Improvement API

The exterior improvement service allows you to virtually transform the appearance of buildings, gardens, terraces, and other outdoor spaces.

Generate an exterior improvement

Request Parameters

string

required

The unique user identifier (UUID)

string

required

URL of the outdoor space image to transform

string

required

The type of outdoor space to improve. Accepted values: JARDIN, GAZON, POOL, BALCON, TERRACE.

boolean

If enabled, preserves the building facade (optional)

boolean

If enabled, adds a blue sky to the image (optional)

string

Webhook URL for notifications (optional)

Available values for room_type

The following values are accepted for the room_type parameter:

JARDIN - Garden with flowers and plants
GAZON - Green lawn
POOL - Garden with swimming pool
BALCON - Balcony or small terrace
TERRACE - Larger terrace

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/exterior/v2/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/exterior.jpg",
    "room_type": "JARDIN",
    "keep_facade": true,
    "blue_sky": true
  }'

Response Example

{
  "generation_id": "123e4567-e89b-12d3-a456-426614174001",
  "remaining_photos": 9,
  "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 type of outdoor space to improve. Accepted values: JARDIN, GAZON, POOL, BALCON, TERRACE.

boolean

If enabled, preserves the building facade (optional)

boolean

If enabled, adds a blue sky to the image (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/exterior/v2/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",
    "room_type": "POOL",
    "keep_facade": false,
    "blue_sky": true
  }'

Response Example

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

Retrieve an exterior improvement

Request Parameters

string

required

The unique user identifier (UUID)

string

required

The unique generation identifier (UUID) returned by the /api/exterior/v2/generate or /api/exterior/v2/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”

string

URL of the transformed image (only present if status=“succeeded”)

Request Example

curl -X POST https://api.iacrea.ai/api/exterior/v2/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",
  "output_url": "https://storage.iacrea.ai/output/123e4567-e89b-12d3-a456-426614174001.jpg"
}

API Documentation

Endpoints

Exterior Improvement API

Exterior Improvement API

Generate an exterior improvement

Request Parameters

Available values for room_type

Response

Request Example

Response Example

Generate a variation

Request Parameters

Response

Request Example

Response Example

Retrieve an exterior improvement

Request Parameters

Response

Request Example

Response Example

​Exterior Improvement API

​Generate an exterior improvement

​Request Parameters

​Available values for room_type

​Response

​Request Example

​Response Example

​Generate a variation

​Request Parameters

​Response

​Request Example

​Response Example

​Retrieve an exterior improvement

​Request Parameters

​Response

​Request Example

​Response Example

Exterior Improvement API

Generate an exterior improvement

Request Parameters

Available values for room_type

Response

Request Example

Response Example

Generate a variation

Request Parameters

Response

Request Example

Response Example

Retrieve an exterior improvement

Request Parameters

Response

Request Example

Response Example