​
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

​
POST /api/exterior/v2/generate

​
Request Parameters

​
user_id
string
required
The unique user identifier (UUID)
​
image_url
string
required
URL of the outdoor space image to transform
​
room_type
string
required
The type of outdoor space to improve. Accepted values: JARDIN, GAZON, POOL, BALCON, TERRACE.
​
keep_facade
boolean
If enabled, preserves the building facade (optional)
​
blue_sky
boolean
If enabled, adds a blue sky to the image (optional)
​
webhook
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

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

​
POST /api/exterior/v2/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
​
room_type
string
required
The type of outdoor space to improve. Accepted values: JARDIN, GAZON, POOL, BALCON, TERRACE.
​
keep_facade
boolean
If enabled, preserves the building facade (optional)
​
blue_sky
boolean
If enabled, adds a blue sky to the image (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/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

​
POST /api/exterior/v2/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/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.
​
status
string
Generation status: “starting”, “in_progress”, “succeeded”, “failed”
​
output_url
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"
}