> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iacrea.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Exterior Creation

> Transform existing outdoor spaces into new visualizations

# Exterior Creation

Our Exterior Creation service allows you to transform specific areas of an image into entirely new and photorealistic outdoor spaces.

## How It Works

Our AI generates exterior visualizations by:

* Analyzing the source image and the area to transform (defined by a mask)
* Creating terraces, swimming pools, or petanque courts according to your needs
* Adapting the style to integrate harmoniously with the rest of the image
* Producing high-quality photorealistic results

## Use Cases

* Visualization of landscaping projects before implementation
* Presentation of concepts to clients (terraces, pools, etc.)
* Virtual transformation of existing outdoor spaces
* Feasibility studies for real estate projects

## API

Integrate this feature into your applications with our simple and powerful API.

### Generate an Exterior

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/create_exterior/generate' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "your-user-id",
  "image_url": "https://example.com/image.jpg",
  "mask_url": "https://example.com/mask.png",
  "room_type": "TERRACE",
  "width": 1024,
  "height": 768
}'
```

### Generate a Variation

You can create variations from a previous generation:

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/create_exterior/generate-variation' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "your-user-id",
  "generation_id": "previous-generation-id",
  "original_url": "https://example.com/image.jpg",
  "room_type": "POOL"
}'
```

### Retrieve Results

Get the results of a generation:

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/create_exterior/get' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "your-user-id",
  "generation_id": "your-generation-id"
}'
```

## Usage Tips

* Provide clear images with good resolution
* Create a precise mask that only delimits the area to transform
* Choose the exterior type suited to your project: TERRACE, POOL, PETANQUE
* Generate multiple variations to explore different possibilities
* For optimal results, ensure that the viewing angle is appropriate for the desired exterior type