> ## 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.

# API Introduction

> Transform empty spaces into warm and welcoming interiors with our white-label service.

# IACrea API

The IACrea API allows you to integrate our powerful image transformation services directly into your applications, websites, and workflows.

## Prerequisites

* To use our API services, you need to create an IACrea account and activate the API offer by contacting us: [contact@iacrea.com](mailto:contact@iacrea.com)
* Generate your API key directly in your Developer Space.
* Each API request must be authenticated using an API key. Please include in the header of all your requests:

```bash theme={null}
x-api-key: [API_KEY]
```

## Request Format

Requests must be sent in JSON format. Each endpoint requires specific parameters detailed in its documentation.

## Response Format

Responses are returned in JSON format with a consistent structure according to the operation type.

## Error Handling

In case of an error, the API returns an appropriate HTTP status code and an explanatory error message.

**Important note:** In case of "FAILED" status, your photos are automatically refunded.

## Available Services

Our API offers several endpoints corresponding to different AI services:

* [Credits](/api-reference/endpoint/credit) - Check your available credits
* [Video](/api-reference/endpoint/video) - Create real estate videos
* [Renovation](/api-reference/endpoint/renovate) - Visualization of renovated spaces
* [Furnishing](/api-reference/endpoint/furnish) - Furnishing of empty spaces
* [Exterior Improvement](/api-reference/endpoint/exterior) - Transformation of exterior appearance
* [Decluttering](/api-reference/endpoint/declutter) - Removal of unwanted objects
* [Blue Sky](/api-reference/endpoint/sky) - Blue sky replacement
* [Interior Sky](/api-reference/endpoint/sky_interior) - Enhancement of interior brightness
* [3D Floor Plan](/api-reference/endpoint/plan) - Generation from a floor plan
* [Targeted Element](/api-reference/endpoint/one_element) - Modification of a specific element
* [Logo Removal](/api-reference/endpoint/remove_logo) - Removal of logos
* [Room Creation](/api-reference/endpoint/create_room) - Creation of a room
* [Exterior Creation](/api-reference/endpoint/create_exterior) - Creation of an outdoor space

## How It Works

1. You send a request to our API to generate a transformation
2. The generation runs asynchronously (can take several minutes)
3. You retrieve the result either via webhook or by querying the retrieval API