> ## 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 Ciel Intérieur

> Documentation de l'API pour l'amélioration du ciel à travers les fenêtres

# API Ciel Intérieur

Le service de Ciel Intérieur vous permet d'améliorer la vue depuis les fenêtres de vos intérieurs en remplaçant le ciel visible par un ciel bleu parfait et en optimisant les paysages visibles.

## Générer un ciel intérieur

**POST /api/sky\_interior/generate**

Appeler cet endpoint lance une nouvelle génération permettant d'améliorer les vues extérieures visibles à travers les fenêtres. Cette opération crée aussi un nouveau projet et, selon votre abonnement, il est possible d'obtenir des variations gratuites.

### Paramètres de la requête

**user\_id** `string` *required*

L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur

**image\_url** `string` *required*

URL de l'image d'intérieur à améliorer (format: jpg, png)

**webhook** `string`

L'URL que nous appelons une fois que la génération est terminée

### Réponse

**generation\_id** `string`

L'identifiant unique de la génération (UUID) à utiliser avec l'API de récupération

**remaining\_photos** `number`

Le nombre de photos restant suite à cette génération

**project\_id** `string`

L'identifiant unique du projet (UUID)

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/sky_interior/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "image_url": "https://exemple.com/interieur.jpg"
}'
```

### Exemple de réponse

```json theme={null}
{
  "generation_id": "uuid",
  "remaining_photos": 100,
  "project_id": "uuid"
}
```

## Générer une variation d'un ciel intérieur

**POST /api/sky\_interior/generate-variation**

Cet endpoint permet de générer une variation d'un ciel intérieur précédemment généré.

### Paramètres de la requête

**user\_id** `string` *required*

L'identifiant unique de l'utilisateur (UUID)

**generation\_id** `string` *required*

L'identifiant unique de la génération précédente

### Réponse

**generation\_id** `string`

L'identifiant unique de la nouvelle génération

**remaining\_photos** `number`

Le nombre de photos restant suite à cette génération

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/sky_interior/generate-variation' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "generation_id": "uuid"
}'
```

### Exemple de réponse

```json theme={null}
{
  "generation_id": "uuid",
  "remaining_photos": 100
}
```

## Récupérer un ciel intérieur généré

**POST /api/sky\_interior/get**

Cet endpoint vous permet d'obtenir le résultat d'une génération précédemment effectuée.

### Paramètres de la requête

**user\_id** `string` *required*

L'identifiant unique de l'utilisateur (UUID)

**generation\_id** `string` *required*

L'identifiant unique de la génération à récupérer

### Réponse

**status** `string`

Le statut de la génération: "STARTING", "PROCESSING", "SUCCEEDED", "FAILED"

**urls** `array`

Un tableau d'URL contenant les URLs des images générées (présent seulement si status="SUCCEEDED")

**variationNumber** `number`

Le nombre de variations déjà effectuées sur ce projet

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/sky_interior/get' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "generation_id": "uuid"
}'
```

### Exemple de réponse

```json theme={null}
{
  "status": "SUCCEEDED",
  "urls": ["https://url-de-image-generée"],
  "variationNumber": 2
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.