# API Création d'Extérieur
Source: https://docs.iacrea.com/api-reference/endpoint/create_exterior

Documentation de l'API pour le service de création d'extérieurs

# API Création d'Extérieur

Le service de Création d'Extérieur vous permet de générer des visualisations réalistes d'espaces extérieurs à partir d'une zone désignée dans une image.

## Générer une création d'extérieur

<ParamField />

Cet endpoint lance une nouvelle génération pour créer un espace extérieur dans une zone spécifiée par un masque. Cette opération crée aussi un nouveau projet.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

<ParamField type="string">
  URL de l'image servant de base à la création (format: jpg, png)
</ParamField>

<ParamField type="string">
  URL du masque indiquant la zone où l'extérieur doit être généré
</ParamField>

<ParamField type="string">
  Type d'extérieur à générer. Valeurs possibles: "TERRACE", "POOL", "PETANQUE"
</ParamField>

<ParamField type="number">
  Largeur de l'image en pixels
</ParamField>

<ParamField type="number">
  Hauteur de l'image en pixels
</ParamField>

<ParamField type="string">
  L'URL que nous appelons une fois que la génération est terminée
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la génération (UUID) à utiliser avec l'API de récupération
</ResponseField>

<ResponseField name="remaining_photos" type="number">
  Le nombre de photos restant suite à cette génération
</ResponseField>

<ResponseField name="project_id" type="string">
  L'identifiant unique du projet (UUID)
</ResponseField>

### Exemple de requête

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

### Exemple de réponse

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

## Générer une variation d'extérieur

<ParamField />

Cet endpoint permet de générer une variation d'une création d'extérieur précédemment réalisée.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération précédente
</ParamField>

<ParamField type="string">
  URL de l'image originale utilisée pour la génération précédente
</ParamField>

<ParamField type="string">
  URL optionnelle d'un nouveau masque. Si non fourni, le masque de la génération précédente sera utilisé
</ParamField>

<ParamField type="string">
  Type d'extérieur pour cette variation. Valeurs possibles: "TERRACE", "POOL", "PETANQUE"
</ParamField>

<ParamField type="string">
  L'URL que nous appelons une fois que la génération est terminée
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la nouvelle génération
</ResponseField>

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/create_exterior/generate-variation' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "generation_id": "uuid",
  "original_url": "https://exemple.com/image.jpg",
  "mask_url": "https://exemple.com/nouveau-masque.png",
  "room_type": "POOL"
}'
```

### Exemple de réponse

```json theme={null}
{
  "generation_id": "uuid"
}
```

## Récupérer une création d'extérieur

<ParamField />

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

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération à récupérer
</ParamField>

### Réponse

<ResponseField name="status" type="string">
  Le statut de la génération: "STARTING", "PROCESSING", "SUCCEEDED", "FAILED"
</ResponseField>

<ResponseField name="urls" type="array">
  Un tableau d'URL contenant les URLs des images générées (présent seulement si status="SUCCEEDED")
</ResponseField>

<ResponseField name="variationNumber" type="number">
  Le nombre de variations déjà effectuées sur ce projet
</ResponseField>

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/create_exterior/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": 0
}
```

**Note importante:** En cas de statut "FAILED", vos photos sont automatiquement remboursées.


# API Création de Pièce
Source: https://docs.iacrea.com/api-reference/endpoint/create_room

Documentation de l'API pour le service de création de pièces

# API Création de Pièce

Le service de Création de Pièce vous permet de générer des visualisations réalistes d'intérieurs à partir d'une zone désignée dans une image.

## Générer une création de pièce

<ParamField />

Cet endpoint lance une nouvelle génération pour créer une pièce dans une zone spécifiée par un masque. Cette opération crée aussi un nouveau projet.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

<ParamField type="string">
  URL de l'image servant de base à la création (format: jpg, png)
</ParamField>

<ParamField type="string">
  URL du masque indiquant la zone où la pièce doit être générée
</ParamField>

<ParamField type="string">
  Type de pièce à générer. Valeurs possibles: "BATHROOM", "KITCHEN", "SHOWEROOM"
</ParamField>

<ParamField type="string">
  Thème de design pour la pièce. Valeurs possibles: "MODERN", "INDUSTRIAL", "SCANDINAVIAN", "LUXURIOUS"
</ParamField>

<ParamField type="number">
  Largeur de l'image en pixels
</ParamField>

<ParamField type="number">
  Hauteur de l'image en pixels
</ParamField>

<ParamField type="string">
  L'URL que nous appelons une fois que la génération est terminée
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la génération (UUID) à utiliser avec l'API de récupération
</ResponseField>

<ResponseField name="remaining_photos" type="number">
  Le nombre de photos restant suite à cette génération
</ResponseField>

<ResponseField name="project_id" type="string">
  L'identifiant unique du projet (UUID)
</ResponseField>

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/create_room/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "image_url": "https://exemple.com/image.jpg",
  "mask_url": "https://exemple.com/masque.png",
  "room_type": "KITCHEN",
  "theme": "MODERN",
  "width": 1024,
  "height": 768
}'
```

### Exemple de réponse

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

## Générer une variation de pièce

<ParamField />

Cet endpoint permet de générer une variation d'une création de pièce précédemment réalisée.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération précédente
</ParamField>

<ParamField type="string">
  URL de l'image originale utilisée pour la génération précédente
</ParamField>

<ParamField type="string">
  URL optionnelle d'un nouveau masque. Si non fourni, le masque de la génération précédente sera utilisé
</ParamField>

<ParamField type="string">
  Type de pièce pour cette variation. Valeurs possibles: "BATHROOM", "KITCHEN", "SHOWEROOM"
</ParamField>

<ParamField type="string">
  Thème de design pour cette variation. Valeurs possibles: "MODERN", "INDUSTRIAL", "SCANDINAVIAN", "LUXURIOUS"
</ParamField>

<ParamField type="string">
  L'URL que nous appelons une fois que la génération est terminée
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la nouvelle génération
</ResponseField>

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/create_room/generate-variation' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "generation_id": "uuid",
  "original_url": "https://exemple.com/image.jpg",
  "mask_url": "https://exemple.com/nouveau-masque.png",
  "room_type": "BATHROOM",
  "theme": "SCANDINAVIAN"
}'
```

### Exemple de réponse

```json theme={null}
{
  "generation_id": "uuid"
}
```

## Récupérer une création de pièce

<ParamField />

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

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération à récupérer
</ParamField>

### Réponse

<ResponseField name="status" type="string">
  Le statut de la génération: "STARTING", "PROCESSING", "SUCCEEDED", "FAILED"
</ResponseField>

<ResponseField name="urls" type="array">
  Un tableau d'URL contenant les URLs des images générées (présent seulement si status="SUCCEEDED")
</ResponseField>

<ResponseField name="variationNumber" type="number">
  Le nombre de variations déjà effectuées sur ce projet
</ResponseField>

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/create_room/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": 0
}
```

**Note importante:** En cas de statut "FAILED", vos photos sont automatiquement remboursées.


# API Crédits
Source: https://docs.iacrea.com/api-reference/endpoint/credit

Documentation de l'API pour la récupération du nombre de crédits disponibles

# API Crédits

Cette API vous permet de récupérer le nombre total de crédits disponibles sur votre compte, incluant les crédits liés à votre abonnement et les crédits supplémentaires.

## Authentification (obligatoire)

Depuis la migration vers l'App Router, l'authentification est **obligatoire** pour cet endpoint :

* **Header `x-api-key`** : Votre clé API (générée dans l'Espace Développeur)
* **Corps de requête `user_id`** : L'identifiant utilisateur associé à cette clé API

La clé API doit correspondre à l'utilisateur dans votre abonnement Home Staging. En cas d'absence ou d'invalidité de la clé, une erreur **401 Unauthorized** sera retournée.

## Récupérer ses crédits

<ParamField />

Ce endpoint vous permet d'obtenir les informations détaillées sur vos crédits disponibles.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

### Réponse

<ResponseField name="total" type="number">
  Le nombre total de crédits disponibles sur votre compte
</ResponseField>

<ResponseField name="subscription" type="number">
  Le nombre de crédits issus de votre abonnement
</ResponseField>

<ResponseField name="extra" type="number">
  Le nombre de crédits supplémentaires achetés séparément
</ResponseField>

### Exemple de requête

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

### Exemple de réponse

```json theme={null}
{
  "total": 100,
  "subscription": 90,
  "extra": 10
}
```

### Codes d'erreur

| Code | Description |
| - | - |
| 400 | Paramètres invalides (ex: `user_id` manquant ou invalide) |
| 401 | Clé API manquante ou invalide (header `x-api-key` requis) |
| 503 | Service temporairement indisponible |


# API Désencombrement
Source: https://docs.iacrea.com/api-reference/endpoint/declutter

Documentation de l'API pour le service de désencombrement d'images

# API Désencombrement

Le service de désencombrement vous permet de supprimer automatiquement les objets indésirables de vos photos d'intérieur, créant ainsi des espaces plus propres et plus attrayants pour vos annonces immobilières.

## Générer une image désencombrée

<ParamField />

Appeler cette endpoint lance une nouvelle génération permettant de désencombrer une image. Cette endpoint créé aussi un nouveau projet, suivant votre abonnement, il est possible sur un même projet d'obtenir des variations gratuites.

Comme une génération peut prendre plusieurs minutes, le résultat n'est pas immédiatement disponible. Vous pouvez soit fournir une URL de webhook, soit interroger régulièrement l'API de récupération.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

<ParamField type="string">
  URL de l'image que vous souhaitez désencombrer (format: jpg, png)
</ParamField>

<ParamField type="string">
  Traitement automatique appliqué à l'image entière, sans masque : `empty` pour vider la pièce de son mobilier et de sa décoration, `tidy` pour la ranger en retirant le bazar, les bibelots, petits objets, livres et objets décoratifs. Ne peut pas être combiné avec `mask_url`.
</ParamField>

<ParamField type="boolean">
  Alias historique de `mode: "empty"`. Si défini à true, l'IA détecte et supprime automatiquement les objets sur l'image entière. Sinon, vous devez fournir un masque.
</ParamField>

<ParamField type="string">
  URL du masque (png) indiquant les zones à désencombrer. Requis lorsque vous ne fournissez ni `mode` ni `auto: true`.
</ParamField>

<ParamField type="string">
  L'URL que nous appelons une fois que la génération est terminée. Le request body est le même que la réponse de l'API de récupération
</ParamField>

**Note importante:** le traitement automatique (`mode` ou `auto: true`) et le traitement masqué (`mask_url`) sont exclusifs. La requête est refusée avec un statut `400` si vous fournissez `mode` **et** `mask_url`, ou si vous ne fournissez aucun des trois (`mode`, `auto: true`, `mask_url`).

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la génération (UUID) à utiliser avec l'API de récupération
</ResponseField>

<ResponseField name="remaining_photos" type="number">
  Le nombre de photos restant suite à cette génération
</ResponseField>

<ResponseField name="project_id" type="string">
  L'identifiant unique du projet (UUID)
</ResponseField>

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/declutter_total/generate' \
--header x-api-key:API_KEY \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
  "mode": "empty"
}'
```

### Exemple de réponse

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

## Générer une variation d'une image désencombrée

<ParamField />

Appeler cette endpoint permet de générer une variation d'une image précédemment désencombrée, en spécifiant éventuellement un nouveau masque. Comme une génération peut prendre plusieurs minutes, le résultat n'est pas immédiatement disponible.

**Note importante:** une variation rejoue le traitement de la génération parente. Le `mode` (ou le `auto`) de la génération d'origine est repris automatiquement ; les champs `mode` et `auto` envoyés dans le corps de la requête sont ignorés. Pour obtenir un traitement différent, lancez une nouvelle génération.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération précédente dont vous souhaitez créer une variation
</ParamField>

<ParamField type="string">
  URL de l'image originale à désencombrer
</ParamField>

<ParamField type="string">
  URL du masque indiquant les zones à désencombrer. Requis uniquement si la génération parente utilisait un masque et que vous souhaitez en changer : sans lui, le masque de la génération parente est réutilisé. Ignoré si la génération parente était automatique (`mode` ou `auto: true`).
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la nouvelle génération (UUID) à utiliser avec l'API de récupération
</ResponseField>

<ResponseField name="remaining_photos" type="number">
  Le nombre de photos restant suite à cette génération
</ResponseField>

### Exemple de requête

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

### Exemple de réponse

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

## Récupérer une image désencombrée

<ParamField />

Ce endpoint vous permet d'obtenir le résultat d'une génération précédemment effectuée. Il permet de savoir où en est votre génération grâce au statut et de récupérer l'url de vos images générées.

**Note importante:** En cas de statut "FAILED", vos photos sont automatiquement remboursées.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération (UUID) retourné par l'API de génération
</ParamField>

### Réponse

<ResponseField name="status" type="string">
  Le status de la génération: "STARTING", "PROCESSING", "SUCCEEDED", "FAILED"
</ResponseField>

<ResponseField name="urls" type="array">
  Un tableau d'URL contenant les URLs des images générées (présent seulement si status="SUCCEEDED")
</ResponseField>

<ResponseField name="variationNumber" type="number">
  Le nombre de variations déjà effectuées sur ce projet
</ResponseField>

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/declutter_total/get' \
--header x-api-key: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
}
```


# API Aménagement Extérieur v3
Source: https://docs.iacrea.com/api-reference/endpoint/exterior

Documentation de l'API pour le service d'aménagement extérieur v3

# API Aménagement Extérieur v3

Le service d'aménagement extérieur v3 vous permet de transformer virtuellement l'aspect extérieur des bâtiments, jardins, terrasses et autres espaces extérieurs avec des options personnalisées avancées.

## Générer un aménagement extérieur

<ParamField />

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  URL de l'image de l'espace extérieur à transformer
</ParamField>

<ParamField type="string">
  Instructions personnalisées pour l'aménagement extérieur (optionnel).
  Exemples: "Ajouter une piscine", "Ajouter un barbecue", "Ajouter du mobilier
  extérieur"
</ParamField>

<ParamField type="string">
  URL du webhook pour les notifications (optionnel)
</ParamField>

<ParamField type="string">
  L'identifiant du projet (optionnel, sera généré automatiquement si non fourni)
</ParamField>

### Options personnalisées

La v3 introduit un système d'options personnalisées qui vous permet de décrire précisément ce que vous souhaitez ajouter à votre extérieur. Voici quelques exemples :

* `"Ajouter une piscine"` - Ajoute une piscine moderne
* `"Ajouter un barbecue"` - Installe un barbecue extérieur
* `"Ajouter du mobilier extérieur"` - Ajoute des meubles de jardin
* `"Ajouter des plantes"` - Enrichit avec des végétaux
* `"Ajouter une terrasse"` - Crée une terrasse en bois
* `"Ajouter un jardin"` - Aménage un jardin paysager

Vous pouvez combiner plusieurs instructions : `"Ajouter une piscine avec terrasse en bois, installer un barbecue moderne"`

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la génération (UUID)
</ResponseField>

<ResponseField name="remaining_photos" type="number">
  Le nombre de crédits photos restants pour l'utilisateur
</ResponseField>

<ResponseField name="project_id" type="string">
  L'identifiant unique du projet (UUID)
</ResponseField>

### Exemple de requête

```bash theme={null}
curl -X POST https://api.iacrea.ai/api/exterior/v3/generate \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "123e4567-e89b-12d3-a456-426614174000",
    "image_url": "https://exemple.com/exterieur.jpg",
    "options": "Ajouter une piscine avec terrasse en bois, installer un barbecue moderne"
  }'
```

### Exemple de réponse

```json theme={null}
{
  "generation_id": "123e4567-e89b-12d3-a456-426614174001",
  "remaining_photos": 9,
  "project_id": "123e4567-e89b-12d3-a456-426614174002"
}
```

## Générer une variation

<ParamField />

Cette API vous permet de générer des variations à partir d'un résultat précédent avec de nouvelles options personnalisées.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  L'identifiant de la génération précédente dont vous souhaitez créer une
  variation
</ParamField>

<ParamField type="string">
  Nouvelles instructions personnalisées pour la variation (optionnel)
</ParamField>

<ParamField type="string">
  URL du webhook pour les notifications (optionnel)
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la nouvelle génération (UUID)
</ResponseField>

### Exemple de requête

```bash theme={null}
curl -X POST https://api.iacrea.ai/api/exterior/v3/generate-variation \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "123e4567-e89b-12d3-a456-426614174000",
    "generation_id": "123e4567-e89b-12d3-a456-426614174001",
    "options": "Ajouter des plantes tropicales et un éclairage extérieur"
  }'
```

### Exemple de réponse

```json theme={null}
{
  "generation_id": "123e4567-e89b-12d3-a456-426614174003"
}
```

## Récupérer un aménagement extérieur

<ParamField />

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération (UUID) retourné par l'endpoint
  `/api/exterior/v3/generate` ou `/api/exterior/v3/generate-variation`
</ParamField>

### Réponse

L'endpoint retourne l'état de la génération et les URLs des images résultantes lorsque le traitement est terminé.

<ResponseField name="status" type="string">
  État de la génération: "starting", "in\_progress", "succeeded", "failed"
</ResponseField>

<ResponseField name="output_url" type="string">
  URL de l'image transformée (uniquement présent si status="succeeded")
</ResponseField>

### Exemple de requête

```bash theme={null}
curl -X POST https://api.iacrea.ai/api/exterior/v3/get \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "123e4567-e89b-12d3-a456-426614174000",
    "generation_id": "123e4567-e89b-12d3-a456-426614174001"
  }'
```

### Exemple de réponse

```json theme={null}
{
  "status": "succeeded",
  "output_url": "https://storage.iacrea.ai/output/123e4567-e89b-12d3-a456-426614174001.jpg"
}
```


# API Ameublement
Source: https://docs.iacrea.com/api-reference/endpoint/furnish

Documentation de l'API pour le service d'ameublement d'espaces

# API Ameublement

Le service d'ameublement vous permet de meubler virtuellement des espaces vides ou de remplacer le mobilier existant dans vos images.

## Générer un ameublement

<ParamField />

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  URL de l'image d'espace à meubler
</ParamField>

<ParamField type="string">
  Le thème d'ameublement souhaité. Valeurs acceptées: MODERN, SCANDINAVIAN,
  COASTAL, FARMHOUSE, LUXURY, AMERICAN.
</ParamField>

<ParamField type="string">
  Le type de pièce à meubler. Valeurs acceptées: LIVING\_ROOM, BEDROOM, DINING,
  HOME\_OFFICE, OFFICE, KIDS, OUTDOOR.
</ParamField>

<ParamField type="string">
  Le mode de génération (optionnel). Valeurs acceptées: "creative" (par défaut),
  "realist". - "creative": Ameublement créatif "realist": Ameublement réaliste
</ParamField>

<ParamField type="string">
  Prompt personnalisé pour l'ameublement (optionnel).
</ParamField>

<ParamField type="string">
  URL du webhook pour les notifications (optionnel)
</ParamField>

### Valeurs disponibles pour room\_type

Les valeurs suivantes sont acceptées pour le paramètre `room_type` :

* `LIVING_ROOM` - Salon
* `BEDROOM` - Chambre
* `DINING` - Salle à manger
* `HOME_OFFICE` - Bureau
* `OFFICE` - Bureau d'entreprise
* `KIDS` - Chambre d'enfant
* `OUTDOOR` - Espace extérieur

### Valeurs disponibles pour theme

Les valeurs suivantes sont acceptées pour le paramètre `theme` :

* `MODERN` - Style moderne
* `SCANDINAVIAN` - Style scandinave
* `COASTAL` - Style bord de mer
* `FARMHOUSE` - Style champêtre
* `LUXURY` - Style luxueux
* `AMERICAN` - Style américain

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la génération (UUID)
</ResponseField>

<ResponseField name="remaining_photos" type="number">
  Le nombre de crédits photos restants pour l'utilisateur
</ResponseField>

<ResponseField name="project_id" type="string">
  L'identifiant unique du projet (UUID)
</ResponseField>

### Exemple de requête

```bash theme={null}
curl -X POST https://api.iacrea.ai/api/furnish/v4/generate \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "123e4567-e89b-12d3-a456-426614174000",
    "image_url": "https://exemple.com/espace-vide.jpg",
    "theme": "MODERN",
    "room_type": "LIVING_ROOM",
  }'
```

### Exemple de réponse

```json theme={null}
{
  "generation_id": "123e4567-e89b-12d3-a456-426614174001",
  "remaining_photos": 7,
  "project_id": "123e4567-e89b-12d3-a456-426614174002"
}
```

## Générer une variation

<ParamField />

Cette API vous permet de générer des variations à partir d'un résultat précédent.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  L'identifiant de la génération précédente dont vous souhaitez créer une
  variation
</ParamField>

<ParamField type="string">
  Le thème d'ameublement souhaité. Valeurs acceptées: MODERN, SCANDINAVIAN,
  COASTAL, FARMHOUSE, LUXURY, AMERICAN.
</ParamField>

<ParamField type="string">
  Le type de pièce à meubler. Valeurs acceptées: LIVING\_ROOM, BEDROOM, DINING,
  HOME\_OFFICE, OFFICE, KIDS, OUTDOOR.
</ParamField>

<ParamField type="string">
  Le mode de génération (optionnel). Valeurs acceptées: "creative" (par défaut),
  "realist". - "creative": Ameublement créatif "realist": Ameublement réaliste
</ParamField>

<ParamField type="string">
  Prompt personnalisé pour l'ameublement (optionnel).
</ParamField>

<ParamField type="string">
  URL du webhook pour les notifications (optionnel)
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la nouvelle génération (UUID)
</ResponseField>

### Exemple de requête

```bash theme={null}
curl -X POST https://api.iacrea.ai/api/furnish/v4/generate-variation \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "123e4567-e89b-12d3-a456-426614174000",
    "generation_id": "123e4567-e89b-12d3-a456-426614174001",
    "theme": "SCANDINAVIAN",
    "room_type": "LIVING_ROOM"
  }'
```

### Exemple de réponse

```json theme={null}
{
  "generation_id": "123e4567-e89b-12d3-a456-426614174003"
}
```

## Récupérer un ameublement

<ParamField />

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération (UUID) retourné par l'endpoint
  `/api/furnish/v4/generate` ou `/api/furnish/v4/generate-variation`
</ParamField>

### Réponse

L'endpoint retourne l'état de la génération et les URLs des images résultantes lorsque le traitement est terminé.

<ResponseField name="status" type="string">
  État de la génération: "starting", "in\_progress", "succeeded", "failed"
</ResponseField>

<ResponseField name="urls" type="array">
  URLs des images meublées (uniquement présent si status="succeeded")
</ResponseField>

<ResponseField name="variationNumber" type="number">
  Numéro de la variation (optionnel)
</ResponseField>

### Exemple de requête

```bash theme={null}
curl -X POST https://api.iacrea.ai/api/furnish/v4/get \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "123e4567-e89b-12d3-a456-426614174000",
    "generation_id": "123e4567-e89b-12d3-a456-426614174001"
  }'
```

### Exemple de réponse

```json theme={null}
{
  "status": "succeeded",
  "urls": [
    "https://storage.iacrea.ai/output/123e4567-e89b-12d3-a456-426614174001.jpg"
  ],
  "variationNumber": 1
}
```


# API Élément Ciblé
Source: https://docs.iacrea.com/api-reference/endpoint/one_element

Documentation de l'API pour la modification d'éléments spécifiques

# API Élément Ciblé

Le service d'Élément Ciblé vous permet de transformer un élément précis d'une image tout en préservant le reste de la composition.

## Modifier un élément

<ParamField />

Cet endpoint lance une nouvelle génération pour modifier un élément spécifique de votre image. Cette opération crée aussi un nouveau projet.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

<ParamField type="string">
  URL de l'image contenant l'élément à modifier (format: jpg, png)
</ParamField>

<ParamField type="string">
  Type d'élément à modifier. Valeurs possibles: "WALL", "FLOOR", "CEILING", "FURNITURE", etc.
</ParamField>

<ParamField type="string">
  L'URL que nous appelons une fois que la génération est terminée
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la génération (UUID) à utiliser avec l'API de récupération
</ResponseField>

<ResponseField name="remaining_photos" type="number">
  Le nombre de photos restant suite à cette génération
</ResponseField>

<ResponseField name="project_id" type="string">
  L'identifiant unique du projet (UUID)
</ResponseField>

### Exemple de requête

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

### Exemple de réponse

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

## Générer une variation d'une modification

<ParamField />

Cet endpoint permet de générer une variation d'une modification d'élément précédemment réalisée.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération précédente
</ParamField>

<ParamField type="string">
  Type d'élément à modifier pour cette variation. Valeurs possibles: "WALL", "FLOOR", "CEILING", "FURNITURE", etc.
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la nouvelle génération
</ResponseField>

### Exemple de requête

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

### Exemple de réponse

```json theme={null}
{
  "generation_id": "uuid"
}
```

## Récupérer une modification générée

<ParamField />

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

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération à récupérer
</ParamField>

### Réponse

<ResponseField name="status" type="string">
  Le statut de la génération: "STARTING", "PROCESSING", "SUCCEEDED", "FAILED"
</ResponseField>

<ResponseField name="urls" type="array">
  Un tableau d'URL contenant les URLs des images générées (présent seulement si status="SUCCEEDED")
</ResponseField>

<ResponseField name="variationNumber" type="number">
  Le nombre de variations déjà effectuées sur ce projet
</ResponseField>

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/one_element/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
}
```

**Note importante:** En cas de statut "FAILED", vos photos sont automatiquement remboursées.


# API Plan 3D
Source: https://docs.iacrea.com/api-reference/endpoint/plan

Documentation de l'API pour le service de génération à partir d'un plan 3D

# API Plan 3D

Le service de Plan 3D vous permet de générer une visualisation réaliste d'un espace à partir d'un plan 3D. Idéal pour visualiser des projets immobiliers avant leur construction.

## Générer une rénovation à partir d'un plan

<ParamField />

Ce endpoint permet de générer une représentation visuelle réaliste à partir d'un plan. Comme une génération peut prendre plusieurs minutes pour s'exécuter, le résultat n'est pas immédiatement disponible.

Pour obtenir le résultat final, vous devez soit fournir une URL de webhook, soit interroger régulièrement l'API de récupération.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

<ParamField type="string">
  URL de l'image du plan à transformer (format: jpg, png)
</ParamField>

<ParamField type="string">
  Thème de votre nouvelle rénovation. Les valeurs dépendent du type de pièce sélectionné.
  Exemples: "MODERN", "SCANDINAVIAN", "LUXURIOUS", etc.
</ParamField>

<ParamField type="string">
  L'URL que nous appelons une fois que la génération est terminée
</ParamField>

<ParamField type="string">
  URL de l'image de référence pour appliquer un style basé sur cette image (format: jpg, png)
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la génération (UUID) à utiliser avec l'API de récupération
</ResponseField>

<ResponseField name="remaining_photos" type="number">
  Le nombre de photos restant suite à cette génération
</ResponseField>

<ResponseField name="project_id" type="string">
  L'identifiant unique du projet (UUID)
</ResponseField>

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/plan/v2/generate' \
--header x-api-key:API_KEY \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
  "theme": "MODERN",
  "room_type": "LIVING_ROOM"
}'
```

### Exemple de réponse

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

## Générer une variation à partir d'un plan

<ParamField />

Ce endpoint permet de générer une variation à partir d'un résultat précédent de génération de plan. Comme une génération peut prendre plusieurs minutes, le résultat n'est pas immédiatement disponible.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération précédente dont vous souhaitez créer une variation
</ParamField>

<ParamField type="string">
  Thème de votre nouvelle rénovation
</ParamField>

<ParamField type="string">
  Votre type de pièce
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la nouvelle génération (UUID) à utiliser avec l'API de récupération
</ResponseField>

<ResponseField name="remaining_photos" type="number">
  Le nombre de photos restant suite à cette génération
</ResponseField>

### Exemple de requête

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

### Exemple de réponse

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

## Récupérer une rénovation générée à partir d'un plan

<ParamField />

Ce endpoint vous permet d'obtenir le résultat d'une génération précédemment effectuée. Il permet de savoir où en est votre génération grâce au statut et de récupérer l'url de vos images générées.

**Note importante:** En cas de statut "FAILED", vos photos sont automatiquement remboursées.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération (UUID) retourné par l'API de génération
</ParamField>

### Réponse

<ResponseField name="status" type="string">
  Le status de la génération: "STARTING", "PROCESSING", "SUCCEEDED", "FAILED"
</ResponseField>

<ResponseField name="urls" type="array">
  Un tableau d'URL contenant les URLs des images générées (présent seulement si status="SUCCEEDED")
</ResponseField>

<ResponseField name="variationNumber" type="number">
  Le nombre de variations déjà effectuées sur ce projet
</ResponseField>

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/plan/v2/get' \
--header x-api-key: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
}
```


# API Suppression de Logo
Source: https://docs.iacrea.com/api-reference/endpoint/remove_logo

Documentation de l'API pour la suppression de logos et filigranes

# API Suppression de Logo

Le service de Suppression de Logo vous permet d'effacer les logos et filigranes de vos images tout en préservant la qualité visuelle.

## Supprimer un logo

<ParamField />

Cet endpoint lance une nouvelle génération pour supprimer un logo ou filigrane d'une image. Cette opération crée aussi un nouveau projet.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

<ParamField type="string">
  URL de l'image contenant le logo à supprimer (format: jpg, png)
</ParamField>

<ParamField type="string">
  URL du masque indiquant la zone du logo à supprimer
</ParamField>

<ParamField type="string">
  L'URL que nous appelons une fois que la génération est terminée
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la génération (UUID) à utiliser avec l'API de récupération
</ResponseField>

<ResponseField name="remaining_photos" type="number">
  Le nombre de photos restant suite à cette génération
</ResponseField>

<ResponseField name="project_id" type="string">
  L'identifiant unique du projet (UUID)
</ResponseField>

### Exemple de requête

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

### Exemple de réponse

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

## Générer une variation de suppression

<ParamField />

Cet endpoint permet de générer une variation d'une suppression de logo précédemment réalisée.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération précédente
</ParamField>

<ParamField type="string">
  URL de l'image originale contenant le logo
</ParamField>

<ParamField type="string">
  URL optionnelle d'un nouveau masque. Si non fourni, le masque de la génération précédente sera utilisé
</ParamField>

<ParamField type="string">
  L'URL que nous appelons une fois que la génération est terminée
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la nouvelle génération
</ResponseField>

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/remove_logo/generate-variation' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "generation_id": "uuid",
  "original_url": "https://exemple.com/image.jpg",
  "mask_url": "https://exemple.com/nouveau-masque.png"
}'
```

### Exemple de réponse

```json theme={null}
{
  "generation_id": "uuid"
}
```

## Récupérer une suppression générée

<ParamField />

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

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération à récupérer
</ParamField>

### Réponse

<ResponseField name="status" type="string">
  Le statut de la génération: "STARTING", "PROCESSING", "SUCCEEDED", "FAILED"
</ResponseField>

<ResponseField name="urls" type="array">
  Un tableau d'URL contenant les URLs des images générées (présent seulement si status="SUCCEEDED")
</ResponseField>

<ResponseField name="variationNumber" type="number">
  Le nombre de variations déjà effectuées sur ce projet
</ResponseField>

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/remove_logo/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": 0
}
```

**Note importante:** En cas de statut "FAILED", vos photos sont automatiquement remboursées.


# API Rénovation
Source: https://docs.iacrea.com/api-reference/endpoint/renovate

Documentation de l'API pour le service de rénovation d'espaces

# API Rénovation

Le service de rénovation vous permet de visualiser comment un espace pourrait apparaître après des travaux de rénovation, sans effectuer les travaux réels.

## Générer une rénovation

<ParamField />

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  URL de l'image de l'espace à rénover
</ParamField>

<ParamField type="string">
  Le thème de décoration souhaité pour la rénovation. Valeurs acceptées: MODERN, SCANDINAVIAN, INDUSTRIAL, LUXURIOUS, FARMHOUSE\_CHIC, KIDS\_ROOM (pour BEDROOM uniquement), MODERN\_POP (pour LIVING\_ROOM et VERANDA uniquement).
</ParamField>

<ParamField type="string">
  Le type de pièce. Valeurs acceptées: LIVING\_ROOM, BEDROOM, BATHROOM, SHOWEROOM, HOME\_OFFICE, EMPTY, VERANDA, KITCHEN, DINING\_ROOM.
</ParamField>

<ParamField type="boolean">
  Si l'image est une photo panoramique à 360°
</ParamField>

<ParamField type="boolean">
  Préserver le plafond original
</ParamField>

<ParamField type="boolean">
  Préserver le sol original
</ParamField>

<ParamField type="boolean">
  Préserver les murs originaux
</ParamField>

<ParamField type="boolean">
  Préserver les portes originales
</ParamField>

<ParamField type="boolean">
  Préserver les fenêtres originales (activé par défaut)
</ParamField>

<ParamField type="boolean">
  Meubler la pièce rénovée. Fonctionne uniquement avec: BEDROOM, DINING\_ROOM, LIVING\_ROOM, HOME\_OFFICE.
</ParamField>

<ParamField type="string">
  URL du webhook pour les notifications (optionnel)
</ParamField>

### Valeurs disponibles pour room\_type

Les valeurs suivantes sont acceptées pour le paramètre `room_type` :

* `LIVING_ROOM` - Salon
* `BEDROOM` - Chambre
* `BATHROOM` - Salle de bain
* `SHOWEROOM` - Salle d'eau
* `HOME_OFFICE` - Bureau à domicile
* `EMPTY` - Pièce vide
* `VERANDA` - Véranda
* `KITCHEN` - Cuisine
* `DINING_ROOM` - Salle à manger

### Valeurs disponibles pour theme

Les valeurs suivantes sont acceptées pour le paramètre `theme` (notez que tous les thèmes ne sont pas disponibles pour tous les types de pièces) :

* `MODERN` - Style moderne
* `SCANDINAVIAN` - Style scandinave
* `INDUSTRIAL` - Style industriel
* `LUXURIOUS` - Style luxueux
* `FARMHOUSE_CHIC` - Style champêtre/rustique
* `KIDS_ROOM` - Chambre d'enfant (pour le type BEDROOM uniquement)
* `MODERN_POP` - Style moderne coloré (uniquement pour LIVING\_ROOM et VERANDA)

### Pièces compatibles avec l'option furnish

L'option `furnish` (meubler) fonctionne uniquement avec les types de pièces suivants :

* `BEDROOM`
* `DINING_ROOM`
* `LIVING_ROOM`
* `HOME_OFFICE`

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la génération (UUID)
</ResponseField>

<ResponseField name="remaining_photos" type="number">
  Le nombre de crédits photos restants pour l'utilisateur
</ResponseField>

<ResponseField name="project_id" type="string">
  L'identifiant unique du projet (UUID)
</ResponseField>

### Exemple de requête

```bash theme={null}
curl -X POST https://api.iacrea.ai/api/renovate/generate \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "123e4567-e89b-12d3-a456-426614174000",
    "image_url": "https://exemple.com/cuisine-avant.jpg",
    "theme": "MODERN",
    "room_type": "KITCHEN",
    "photo_360": false,
    "keep_ceiling": false,
    "keep_floor": false,
    "keep_wall": false,
    "keep_door": true,
    "keep_window": true,
    "furnish": true
  }'
```

### Exemple de réponse

```json theme={null}
{
  "generation_id": "123e4567-e89b-12d3-a456-426614174001",
  "remaining_photos": 6,
  "project_id": "123e4567-e89b-12d3-a456-426614174002"
}
```

## Générer une variation

<ParamField />

Cette API vous permet de générer des variations à partir d'un résultat précédent.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  L'identifiant de la génération précédente dont vous souhaitez créer une variation
</ParamField>

<ParamField type="string">
  Le nouveau thème de décoration souhaité. Valeurs acceptées: MODERN, SCANDINAVIAN, INDUSTRIAL, LUXURIOUS, FARMHOUSE\_CHIC, KIDS\_ROOM (pour BEDROOM uniquement), MODERN\_POP (pour LIVING\_ROOM et VERANDA uniquement).
</ParamField>

<ParamField type="string">
  Le type de pièce. Valeurs acceptées: LIVING\_ROOM, BEDROOM, BATHROOM, SHOWEROOM, HOME\_OFFICE, EMPTY, VERANDA, KITCHEN, DINING\_ROOM.
</ParamField>

<ParamField type="boolean">
  Si l'image est une photo panoramique à 360°
</ParamField>

<ParamField type="boolean">
  Préserver le plafond original
</ParamField>

<ParamField type="boolean">
  Préserver le sol original
</ParamField>

<ParamField type="boolean">
  Préserver les murs originaux
</ParamField>

<ParamField type="boolean">
  Préserver les portes originales
</ParamField>

<ParamField type="boolean">
  Préserver les fenêtres originales (activé par défaut)
</ParamField>

<ParamField type="boolean">
  Meubler la pièce rénovée. Fonctionne uniquement avec: BEDROOM, DINING\_ROOM, LIVING\_ROOM, HOME\_OFFICE.
</ParamField>

<ParamField type="string">
  URL du webhook pour les notifications (optionnel)
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la nouvelle génération (UUID)
</ResponseField>

### Exemple de requête

```bash theme={null}
curl -X POST https://api.iacrea.ai/api/renovate/generate-variation \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "123e4567-e89b-12d3-a456-426614174000",
    "generation_id": "123e4567-e89b-12d3-a456-426614174001",
    "theme": "SCANDINAVIAN",
    "room_type": "KITCHEN",
    "photo_360": false,
    "keep_ceiling": true,
    "keep_floor": false,
    "keep_wall": false,
    "keep_door": true,
    "keep_window": true,
    "furnish": true
  }'
```

### Exemple de réponse

```json theme={null}
{
  "generation_id": "123e4567-e89b-12d3-a456-426614174003"
}
```

## Récupérer une rénovation

<ParamField />

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération (UUID) retourné par l'endpoint `/api/renovate/generate` ou `/api/renovate/generate-variation`
</ParamField>

### Réponse

L'endpoint retourne l'état de la génération et les URLs des images résultantes lorsque le traitement est terminé.

<ResponseField name="status" type="string">
  État de la génération: "starting", "in\_progress", "succeeded", "failed"
</ResponseField>

<ResponseField name="output_url" type="string">
  URL de l'image rénovée (uniquement présent si status="succeeded")
</ResponseField>

### Exemple de requête

```bash theme={null}
curl -X POST https://api.iacrea.ai/api/renovate/get \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "123e4567-e89b-12d3-a456-426614174000",
    "generation_id": "123e4567-e89b-12d3-a456-426614174001"
  }'
```

### Exemple de réponse

```json theme={null}
{
  "status": "succeeded",
  "output_url": "https://storage.iacrea.ai/output/123e4567-e89b-12d3-a456-426614174001.jpg"
}
```


# API Ciel Bleu
Source: https://docs.iacrea.com/api-reference/endpoint/sky

Documentation de l'API pour le service d'obtention d'un ciel bleu

# API Ciel Bleu

Le service de ciel bleu vous permet de transformer un ciel nuageux, gris ou peu attrayant en un ciel bleu éclatant, améliorant ainsi considérablement l'apparence de vos photos extérieures.

## Générer un ciel bleu

<ParamField />

Appeler cette endpoint lance une nouvelle génération permettant d'obtenir un ciel bleu. Cette endpoint créé aussi un nouveau projet, suivant votre abonnement, il est possible sur un même projet d'obtenir des variations gratuites.

Comme une génération peut prendre plusieurs minutes, le résultat n'est pas immédiatement disponible. Vous pouvez soit fournir une URL de webhook, soit interroger régulièrement l'API de récupération.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

<ParamField type="string">
  URL de l'image dont vous voulez modifier le ciel (format: jpg, png)
</ParamField>

<ParamField type="string">
  L'URL que nous appelons une fois que la génération est terminée. Le request body est le même que la réponse de l'API de récupération
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la génération (UUID) à utiliser avec l'API de récupération
</ResponseField>

<ResponseField name="remaining_photos" type="number">
  Le nombre de photos restant suite à cette génération
</ResponseField>

<ResponseField name="project_id" type="string">
  L'identifiant unique du projet (UUID)
</ResponseField>

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/sky/generate' \
--header x-api-key:API_KEY \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "image_url": "https://my-image-url.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 bleu

<ParamField />

Appeler cette endpoint permet de générer une variation d'un ciel bleu précedemment généré. Comme une génération peut prendre plusieurs minutes, le résultat n'est pas immédiatement disponible.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération précédente dont vous souhaitez créer une variation
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la nouvelle génération (UUID) à utiliser avec l'API de récupération
</ResponseField>

<ResponseField name="remaining_photos" type="number">
  Le nombre de photos restant suite à cette génération
</ResponseField>

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/sky/generate-variation' \
--header x-api-key: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 bleu

<ParamField />

Ce endpoint vous permet d'obtenir le résultat d'une génération précédemment effectuée. Il permet de savoir où en est votre génération grâce au statut et de récupérer l'url de vos images générées.

**Note importante:** En cas de statut "FAILED", vos photos sont automatiquement remboursées.

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération (UUID) retourné par l'API de génération
</ParamField>

### Réponse

<ResponseField name="status" type="string">
  Le status de la génération: "STARTING", "PROCESSING", "SUCCEEDED", "FAILED"
</ResponseField>

<ResponseField name="urls" type="array">
  Un tableau d'URL contenant les URLs des images générées (présent seulement si status="SUCCEEDED")
</ResponseField>

<ResponseField name="variationNumber" type="number">
  Le nombre de variations déjà effectuées sur ce projet
</ResponseField>

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/sky/get' \
--header x-api-key: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
}
```


# API Ciel Intérieur
Source: https://docs.iacrea.com/api-reference/endpoint/sky_interior

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

<ParamField />

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

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

<ParamField type="string">
  URL de l'image d'intérieur à améliorer (format: jpg, png)
</ParamField>

<ParamField type="string">
  L'URL que nous appelons une fois que la génération est terminée
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la génération (UUID) à utiliser avec l'API de récupération
</ResponseField>

<ResponseField name="remaining_photos" type="number">
  Le nombre de photos restant suite à cette génération
</ResponseField>

<ResponseField name="project_id" type="string">
  L'identifiant unique du projet (UUID)
</ResponseField>

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

<ParamField />

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

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération précédente
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la nouvelle génération
</ResponseField>

<ResponseField name="remaining_photos" type="number">
  Le nombre de photos restant suite à cette génération
</ResponseField>

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

<ParamField />

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

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID)
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération à récupérer
</ParamField>

### Réponse

<ResponseField name="status" type="string">
  Le statut de la génération: "STARTING", "PROCESSING", "SUCCEEDED", "FAILED"
</ResponseField>

<ResponseField name="urls" type="array">
  Un tableau d'URL contenant les URLs des images générées (présent seulement si status="SUCCEEDED")
</ResponseField>

<ResponseField name="variationNumber" type="number">
  Le nombre de variations déjà effectuées sur ce projet
</ResponseField>

### 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
}
```


# API Création de Vidéos
Source: https://docs.iacrea.com/api-reference/endpoint/video

Documentation de l'API pour le service de création de vidéos

# API Création de Vidéos

Le service de création de vidéos vous permet de transformer vos images statiques en animations dynamiques grâce à l'intelligence artificielle.

## Générer une vidéo

<ParamField />

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

<ParamField type="array">
  Tableau d'URLs des images à animer. Actuellement, la première image du tableau est utilisée pour la création de la vidéo.
</ParamField>

<ParamField type="string">
  Type d'animation souhaité. Valeurs possibles: "ZOOM\_IN", "ZOOM\_OUT", "PAN\_RIGHT", "PAN\_LEFT", "PAN\_UP", "PAN\_DOWN", "CAMERA\_PUSH\_OUT", "AUTO\_EFFECTS", "AUTO\_REVERSE"
</ParamField>

<ParamField type="string">
  Description textuelle pour guider le style visuel de l'animation. Utilisé uniquement si l'option n'est pas "AUTO\_EFFECTS" ou "AUTO\_REVERSE". Pour ces options automatiques, le prompt est généré automatiquement par l'IA.
</ParamField>

<ParamField type="string">
  Format d'orientation de la vidéo. Valeurs possibles: "portrait" (format 768x1280) ou toute autre valeur pour le format paysage (1280x768). Par défaut, le format paysage est utilisé.
</ParamField>

<ParamField type="string">
  URL du webhook pour recevoir une notification lorsque la génération est terminée
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la génération (UUID) à utiliser avec l'API de récupération
</ResponseField>

<ResponseField name="remaining_videos" type="number">
  Le nombre de crédits vidéos restants pour l'utilisateur
</ResponseField>

<ResponseField name="project_id" type="string">
  L'identifiant unique du projet (UUID)
</ResponseField>

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/animation/v2/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "image_urls": ["https://exemple.com/image.jpg"],
  "option": "ZOOM_OUT",
  "prompt": "Élégant salon moderne",
  "format": "portrait"
}'
```

### Exemple de réponse

```json theme={null}
{
  "generation_id": "uuid",
  "remaining_videos": 10,
  "project_id": "uuid"
}
```

## Types d'animations disponibles

| Option | Description |
| - | - |
| ZOOM\_IN | Effet de zoom avant vers l'intérieur de l'image |
| ZOOM\_OUT | Effet de zoom arrière s'éloignant de l'image |
| PAN\_RIGHT | Déplacement de la caméra vers la droite |
| PAN\_LEFT | Déplacement de la caméra vers la gauche |
| PAN\_UP | Déplacement de la caméra vers le haut |
| PAN\_DOWN | Déplacement de la caméra vers le bas |
| CAMERA\_PUSH\_OUT | Mouvement fluide combinant zoom et déplacement |
| AUTO\_EFFECTS | Génération automatique du prompt par l'IA pour créer une animation optimale |
| AUTO\_REVERSE | Génération automatique du prompt par l'IA pour créer une animation en sens inverse |

## Récupérer une vidéo

<ParamField />

### Paramètres de la requête

<ParamField type="string">
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

<ParamField type="string">
  L'identifiant unique de la génération (UUID) retourné par l'API de génération
</ParamField>

### Réponse

<ResponseField name="status" type="string">
  État de la génération: "STARTING", "IN\_PROGRESS", "SUCCEEDED", "FAILED"
</ResponseField>

<ResponseField name="urls" type="array">
  Tableau contenant les URLs des vidéos générées (présent seulement si status="SUCCEEDED")
</ResponseField>

### Exemple de requête

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/animation/v2/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-video-generée.mp4"]
}
```

### États possibles de la génération

| Status | Description |
| - | - |
| STARTING | La génération est en cours d'initialisation |
| IN\_PROGRESS | La vidéo est en cours de création |
| SUCCEEDED | La génération est terminée avec succès |
| FAILED | Une erreur s'est produite lors de la génération |

**Note importante:** En cas de statut "FAILED", vos crédits vidéos sont automatiquement remboursés.


# API Vidéo Auto (workflow)
Source: https://docs.iacrea.com/api-reference/endpoint/video_auto

Documentation complète du workflow de génération automatique de vidéo + polling de statut

# API Vidéo Auto (workflow)

Cette API permet de générer automatiquement une vidéo à partir d’une annonce (description + images), en s’appuyant sur l’IA pour :

* sélectionner **jusqu’à 5** images pertinentes (selon le nombre fourni)
* générer un texte court par image
* lancer la génération des clips vidéo pour chaque image
* assembler / rendre la vidéo finale

Le workflow se fait en **2 endpoints** :

* **1) POST** `"/api/video-editor/generate/video/auto"` : démarre la génération et renvoie un `id`
* **2) GET** `"/api/video-editor/generate/video/auto/{id}"` : permet de suivre l’avancement

## Authentification

Toutes les requêtes doivent inclure l’en-tête :

* `x-api-key: VOTRE_API_KEY`

## 1) Démarrer une génération

<ParamField />

### En-têtes

<ParamField type="string">
  Votre clé API IACrea
</ParamField>

<ParamField type="string">
  Doit être `application/json`
</ParamField>

### Corps de requête

<ParamField type="array">
  Tableau d’URLs d’images (format URL). **Minimum 1**.
</ParamField>

<ParamField type="string">
  Description textuelle de l’annonce (minimum 10 caractères). La langue détectée
  est utilisée pour les textes générés.
</ParamField>

<ParamField type="string">
  Format de la vidéo : `"landscape" | "portrait" | "square"`. Défaut :
  `"landscape"`.
</ParamField>

<ParamField type="array">
  Deux couleurs `[background, text]` (ex : `["#1a1a2e", "#ffffff"]`). Optionnel.
</ParamField>

<ParamField type="string">
  Police (ex : `"Inter"`). Optionnel.
</ParamField>

<ParamField type="string">
  Musique (identifiant interne / valeur attendue par votre implémentation).
  Optionnel.
</ParamField>

<ParamField type="boolean">
  Afficher un logo sur la vidéo. Défaut : `false`.
</ParamField>

<ParamField type="string">
  URL du logo (nécessaire si `displayLogo=true`). Optionnel.
</ParamField>

<ParamField type="string">
  URL appelée par IACrea quand la vidéo est **DONE** (voir section Webhook).
  Optionnel.
</ParamField>

### Réponses

#### 201 — Démarré

<ResponseField name="id" type="string">
  Identifiant de la génération auto. À utiliser dans le endpoint de suivi `GET
      /api/video-editor/generate/video/auto/{id}`.
</ResponseField>

<ResponseField name="status" type="string">
  Statut initial, typiquement `"PENDING"`.
</ResponseField>

<ResponseField name="generatedContent" type="array">
  Liste des clips / séquences en cours de génération (un élément par image
  sélectionnée). Chaque élément contient `id`, `url`, `effect`, `format`,
  `category`, `text`, `status`.
</ResponseField>

<ResponseField name="analysis" type="object">
  Résultat de l’analyse IA (sélections).
</ResponseField>

<ResponseField name="creditsTotal" type="number">
  Crédits restants.
</ResponseField>

<ResponseField name="creditsUsed" type="number">
  Crédits utilisés.
</ResponseField>

#### 400 — Validation error

Renvoyé si le corps de requête est invalide (ex : `image_urls` vide, URL invalide, description trop courte, etc.).

#### 401 — Unauthorized

Renvoi si `x-api-key` manquant ou invalide.

#### 500 — Server error

Erreur serveur (ex : échec d’analyse IA, erreur interne).

### Exemple (curl)

```bash theme={null}
curl --request POST \
  --url 'https://iacrea.com/api/video-editor/generate/video/auto' \
  --header 'x-api-key: VOTRE_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "image_urls": [
      "https://exemple.com/1.jpg",
      "https://exemple.com/2.jpg"
    ],
    "description": "Appartement lumineux avec terrasse, proche centre-ville.",
    "format": "landscape",
    "webhookUrl": "https://votre-app.com/webhooks/iacrea/video-auto"
  }'
```

## 2) Suivre une génération (polling)

<ParamField />

### En-têtes

<ParamField type="string">
  Votre clé API IACrea
</ParamField>

### Réponses (principales)

Ce endpoint est **idempotent** et peut être appelé régulièrement (polling). Il renvoie un objet JSON avec un champ `status` et, selon le statut, des champs additionnels.

#### 200 — `status: "GENERATING_VIDEO"`

La génération des clips (séquences) est en cours. Retourne aussi les crédits et `generatedContent`.

#### 200 — `status: "START_RENDERING_VIDEO"`

Toutes les séquences sont prêtes et le rendu final démarre.

* `progress: 0`

#### 200 — `status: "RENDERING_VIDEO"`

Rendu final en cours.

* `progress`: nombre entre 0 et 1 (ou 0–100 selon votre implémentation côté client, à afficher tel quel).

#### 200 — `status: "DONE"`

Vidéo finale disponible.

* `url`: URL de la vidéo
* `generatedContent`: détails des séquences
* `creditsTotal`, `creditsUsed`

#### 200 — `status: "PENDING"`

État transitoire. Peut aussi être renvoyé lorsqu’une séquence est en erreur et qu’une régénération est relancée côté serveur.

#### 4xx/5xx

* `401` si API key manquante/invalide
* `404` si `id` inexistant
* `500` en cas d’erreur serveur

### Exemple (curl)

```bash theme={null}
curl --request GET \
  --url 'https://iacrea.com/api/video-editor/generate/video/auto/ID_RETOURNE_PAR_LE_POST' \
  --header 'x-api-key: VOTRE_API_KEY'
```

## Webhook (optionnel)

Si `webhookUrl` est fourni au moment du `POST`, IACrea appellera votre endpoint quand la vidéo finale est prête :

* Méthode : `POST`
* Header : `Content-Type: application/json`
* Body :

```json theme={null}
{
  "id": "ID_DE_LA_GENERATION",
  "status": "DONE",
  "url": "https://...mp4"
}
```

### Recommandations d’intégration

* **Polling** : appelez `GET /api/video-editor/generate/video/auto/{id}` toutes les 2–5 secondes jusqu’à `DONE` (ou `ERROR`).
* **Timeout** : prévoyez un timeout côté client (ex : 10–20 minutes) selon la durée de rendu.
* **Résilience** : si vous recevez `"PENDING"` après avoir déjà vu `"GENERATING_VIDEO"`, continuez le polling : le serveur peut relancer des séquences en erreur.


# API Vidéo - Création
Source: https://docs.iacrea.com/api-reference/endpoint/video_create

Créer une vidéo complète avec intro, outro, séquences animées, transitions et effets avant/après

# API Vidéo - Création

Crée une vidéo complète avec plusieurs séquences. Chaque séquence peut contenir des médias (images ou vidéos) animés selon le type d'animation spécifié. Vous pouvez ajouter une intro, une outro, des transitions entre séquences, un logo, et des effets avant/après.

<ParamField />

## Authentification

Toutes les requêtes doivent inclure l'en-tête :

* `x-api-key: VOTRE_API_KEY`

## En-têtes

<ParamField type="string">
  Votre clé API IACrea
</ParamField>

<ParamField type="string">
  Doit être `application/json`
</ParamField>

## Corps de requête

<ParamField type="object">
  Objet vidéo contenant toutes les séquences et paramètres
</ParamField>

<ParamField type="string">
  Format de la vidéo : `"landscape" | "portrait" | "square"`
</ParamField>

<ParamField type="string">
  Template vidéo. Défaut : `"SaleProperty"`. Optionnel.
</ParamField>

<ParamField type="string">
  URL de la musique de fond. Optionnel.
</ParamField>

<ParamField type="string">
  Police de caractères (ex : `"Inter"`). Défaut : `"Inter"`. Optionnel.
</ParamField>

<ParamField type="array">
  Tableau de deux couleurs `[background, text]` (ex : `["#1a1a2e", "#ffffff"]`).
  La première couleur est le fond, la seconde la couleur du texte.
</ParamField>

<ParamField type="boolean">
  Active l'affichage du logo sur les séquences vidéo/image (coin supérieur
  droit, 100 px). Le logo sur les intro/outro est contrôlé séparément via
  `sequence.data.displayLogo`.
</ParamField>

<ParamField type="string">
  URL du logo. Nécessaire si `displayLogo=true` ou si vous souhaitez afficher le
  logo sur les intros/outros. Optionnel.
</ParamField>

## Séquences

<ParamField type="array">
  Tableau de séquences vidéo ordonnées. Chaque séquence représente un clip dans
  la vidéo finale. Les séquences sont composées dans l'ordre de leur champ
  `order`.
</ParamField>

<ParamField type="number">
  Ordre d'affichage de la séquence dans la vidéo (commence à 0). L'intro doit
  être en premier (`0`), l'outro en dernier.
</ParamField>

<ParamField type="number">
  Durée de la séquence en secondes. - Séquences `"video"` : max 5 secondes
  (plafonné automatiquement) - Séquences `"intro"` : 2 à 5 secondes (recommandé
  : 3) - Séquences `"outro"` : 3 à 5 secondes (recommandé : 5) - Séquences
  `"image"` : libre
</ParamField>

<ParamField type="string">
  Type de séquence : - `"intro"` — Écran d'introduction (logo + texte de
  présentation) - `"outro"` — Écran de fin (logo + coordonnées ou texte) -
  `"video"` — Séquence vidéo animée (déclenche la génération IA) - `"image"` —
  Séquence image statique - `"beforeAfter"` — Séquence avant/après (slide
  comparatif statique)
</ParamField>

<ParamField type="string">
  Type d'animation. Valeurs possibles :

  **Mouvements de caméra :**

  * `"CAMERA_PUSH_IN"` — Zoom avant
  * `"CAMERA_PUSH_OUT"` — Zoom arrière
  * `"CAMERA_MOVE_RIGHT"` — Déplacement vers la droite
  * `"CAMERA_CRANE_UP"` — Mouvement vers le haut
  * `"CAMERA_ORBIT_LEFT"` — Rotation vers la gauche

  **Effets automatiques IA :**

  * `"AUTO_EFFECTS"` — Animation automatique (prompt généré par IA)
  * `"AUTO_REVERSE"` — Animation automatique inversée

  **Effets spéciaux :**

  * `"REALTOR_SMILING"` — Animation portrait agent immobilier

  **Avant/Après (nécessitent 2 images) :**

  * `"BEFORE_AFTER_INTERIOR"` — Transformation intérieur (meublage progressif)
  * `"BEFORE_AFTER_EXTERIOR"` — Transformation extérieur (aménagement paysager)
  * `"BEFORE_AFTER_DECLUTTER"` — Débarras (meubles qui disparaissent)
  * `"BEFORE_AFTER_RENOVATION"` — Rénovation (timelapse avec équipe de rénovation)

  **Sans animation :**

  * `"none"` — Aucune animation
  * `"fade"` — Fondu simple
</ParamField>

## Médias

<ParamField type="array">
  Tableau de médias pour cette séquence. Au moins un média requis pour les types
  `"video"` et `"image"`. Les séquences `"intro"` et `"outro"` n'ont pas besoin
  de médias (tableau vide `[]`).
</ParamField>

<ParamField type="string">
  URL de l'image ou de la vidéo source. Pour les effets BEFORE\_AFTER, il s'agit
  de l'image **"avant"**.
</ParamField>

<ParamField type="number">
  Temps de début du média dans la séquence (en secondes). Généralement `0`.
</ParamField>

<ParamField type="number">
  Temps de fin du média dans la séquence (en secondes). Doit correspondre à la
  durée.
</ParamField>

<ParamField type="number">
  Ordre du média dans la séquence. Optionnel. Défaut : `0`.
</ParamField>

<ParamField type="boolean">
  Média actif dans la séquence. Mettez `true` pour le média principal.
  Optionnel.
</ParamField>

## Données de séquence (data)

<ParamField type="object">
  Données supplémentaires pour la séquence. Le contenu varie selon le type de
  séquence.
</ParamField>

### Données Intro (`type: "intro"`)

<ParamField type="string">
  Texte affiché sous le logo (ex : `"vous présente"`, `"À vendre"`).
</ParamField>

<ParamField type="boolean">
  Afficher le logo (de `video.logoUrl`) sur l'intro. Défaut : `true`.
</ParamField>

<ParamField type="string">
  Couleur de fond personnalisée pour l'intro (ex : `"#1a1a2e"`). Défaut :
  première couleur de `video.colors`.
</ParamField>

### Données Outro (`type: "outro"`)

<ParamField type="string">
  URL de la photo de profil (agent, conseiller). Affichée en cercle.
</ParamField>

<ParamField type="boolean">
  Afficher l'avatar sur l'outro. Défaut : `true`.
</ParamField>

<ParamField type="string">
  Nom affiché sur l'outro (ex : `"Jean Dupont"`).
</ParamField>

<ParamField type="string">
  Email affiché sur l'outro.
</ParamField>

<ParamField type="string">
  Téléphone affiché sur l'outro.
</ParamField>

<ParamField type="boolean">
  Afficher le logo (de `video.logoUrl`) sur l'outro. Défaut : `true`.
</ParamField>

<ParamField type="string">
  Couleur de fond personnalisée pour l'outro.
</ParamField>

Pour les templates `Interview` et `Sample` (générique) :

<ParamField type="string">
  Titre affiché sur l'outro.
</ParamField>

<ParamField type="string">
  Description affichée sous le titre.
</ParamField>

### Données Before/After

<ParamField type="string">
  **Requis pour les effets BEFORE\_AFTER.** URL de l'image "après"
  transformation. L'image "avant" est fournie via `medias[0].url`.
</ParamField>

## Transitions

Les transitions définissent comment une séquence **entre en scène** par rapport à la précédente.
La transition est définie dans le champ `data.transition` de la séquence cible.

<ParamField type="object">
  Configuration de la transition d'entrée pour cette séquence.
</ParamField>

<ParamField type="string">
  Type de transition : - `"fade"` — Fondu enchaîné (défaut) - `"wipe"` —
  Balayage horizontal - `"slide"` — Glissement - `"flip"` — Retournement -
  `"clock-wipe"` — Balayage en horloge - `"iris"` — Ouverture circulaire -
  `"none"` — Pas de transition
</ParamField>

<ParamField type="number">
  Durée de la transition en **frames** (1 à 120). À 30 fps : - `15` ≈ 0.5
  seconde - `20` ≈ 0.67 seconde (défaut) - `30` ≈ 1 seconde - `60` ≈ 2 secondes
</ParamField>

## Logo — Comportement détaillé

Le logo est contrôlé à deux niveaux :

1. **Niveau vidéo** (`video.displayLogo` + `video.logoUrl`) :
   * Active l'affichage du logo en **coin supérieur droit** (100 px) sur les séquences de type `"video"` et `"image"`.

2. **Niveau séquence** (`sequence.data.displayLogo`) :
   * Sur les `"intro"` et `"outro"` : le logo de `video.logoUrl` est affiché **centré** (200 px pour l'intro, 150 px pour l'outro).
   * Contrôlé individuellement par `sequence.data.displayLogo` (défaut `true`).
   * Pour masquer le logo sur une intro/outro spécifique, passez `"displayLogo": false` dans son `data`.

## Webhook

<ParamField type="string">
  URL du webhook pour recevoir une notification lorsque la vidéo est terminée.
  Optionnel.
</ParamField>

## Réponses

### 201 — Créé avec succès

<ResponseField name="id" type="string">
  Identifiant unique de la vidéo générée. À utiliser avec `GET
      /api/video-editor/generate/video/{id}` pour suivre l'avancement.
</ResponseField>

<ResponseField name="generatedContent" type="array">
  Liste des contenus générés (un élément par séquence de type `"video"`). Chaque
  élément contient : - `id` : Identifiant de génération - `url` : URL de l'image
  source - `effect` : Type d'animation - `format` : Format de la vidéo -
  `status` : Statut (`"pending" | "success" | "error"`)
</ResponseField>

<ResponseField name="creditsTotal" type="number">
  Nombre de crédits restants
</ResponseField>

<ResponseField name="creditsUsed" type="number">
  Nombre de crédits utilisés pour cette génération
</ResponseField>

### 400 — Erreur de validation

Renvoyé si le corps de requête est invalide (séquence manquante, format invalide, etc.).

### 401 — Non autorisé

Renvoyé si `x-api-key` est manquant ou invalide.

### 500 — Erreur serveur

Erreur interne du serveur.

***

## Exemples

### Exemple 1 — Vidéo basique avec intro + outro + logo

```bash theme={null}
curl --request POST \
  --url 'https://iacrea.com/api/video-editor/generate/video' \
  --header 'x-api-key: VOTRE_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "video": {
      "format": "landscape",
      "template": "SaleProperty",
      "music": "https://exemple.com/music.mp3",
      "font": "Inter",
      "colors": ["#1a1a2e", "#ffffff"],
      "displayLogo": true,
      "logoUrl": "https://exemple.com/logo.png",
      "sequences": [
        {
          "order": 0,
          "duration": 3,
          "type": "intro",
          "animationType": "fade",
          "medias": [],
          "data": {
            "description": "vous présente",
            "displayLogo": true
          }
        },
        {
          "order": 1,
          "duration": 5,
          "type": "video",
          "animationType": "CAMERA_PUSH_IN",
          "medias": [
            {
              "url": "https://exemple.com/salon.jpg",
              "start": 0,
              "end": 5,
              "order": 0,
              "selected": true
            }
          ],
          "data": {
            "description": "Salon lumineux avec vue sur jardin"
          }
        },
        {
          "order": 2,
          "duration": 5,
          "type": "video",
          "animationType": "CAMERA_PUSH_OUT",
          "medias": [
            {
              "url": "https://exemple.com/chambre.jpg",
              "start": 0,
              "end": 5,
              "order": 0,
              "selected": true
            }
          ]
        },
        {
          "order": 3,
          "duration": 5,
          "type": "outro",
          "animationType": "fade",
          "medias": [],
          "data": {
            "avatar": "https://exemple.com/photo-agent.jpg",
            "displayAvatar": true,
            "name": "Jean Dupont",
            "email": "jean.dupont@agence.fr",
            "tel": "06 12 34 56 78",
            "displayLogo": true
          }
        }
      ]
    },
    "webhookUrl": "https://votre-app.com/webhooks/iacrea/video"
  }'
```

### Exemple 2 — Vidéo avec transitions entre séquences

```bash theme={null}
curl --request POST \
  --url 'https://iacrea.com/api/video-editor/generate/video' \
  --header 'x-api-key: VOTRE_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "video": {
      "format": "portrait",
      "template": "SaleProperty",
      "font": "Inter",
      "colors": ["#ffffff", "#333333"],
      "displayLogo": true,
      "logoUrl": "https://exemple.com/logo.png",
      "sequences": [
        {
          "order": 0,
          "duration": 3,
          "type": "intro",
          "animationType": "fade",
          "medias": [],
          "data": {
            "description": "Nouveau bien à la vente",
            "displayLogo": true
          }
        },
        {
          "order": 1,
          "duration": 5,
          "type": "video",
          "animationType": "CAMERA_PUSH_IN",
          "medias": [
            {
              "url": "https://exemple.com/facade.jpg",
              "start": 0,
              "end": 5,
              "order": 0,
              "selected": true
            }
          ],
          "data": {
            "description": "Vue extérieure",
            "transition": {
              "type": "wipe",
              "duration": 25
            }
          }
        },
        {
          "order": 2,
          "duration": 5,
          "type": "video",
          "animationType": "CAMERA_ORBIT_LEFT",
          "medias": [
            {
              "url": "https://exemple.com/salon.jpg",
              "start": 0,
              "end": 5,
              "order": 0,
              "selected": true
            }
          ],
          "data": {
            "transition": {
              "type": "slide",
              "duration": 20
            }
          }
        },
        {
          "order": 3,
          "duration": 5,
          "type": "video",
          "animationType": "CAMERA_CRANE_UP",
          "medias": [
            {
              "url": "https://exemple.com/cuisine.jpg",
              "start": 0,
              "end": 5,
              "order": 0,
              "selected": true
            }
          ],
          "data": {
            "transition": {
              "type": "flip",
              "duration": 30
            }
          }
        },
        {
          "order": 4,
          "duration": 5,
          "type": "outro",
          "animationType": "fade",
          "medias": [],
          "data": {
            "name": "Marie Martin",
            "email": "marie@agence.fr",
            "tel": "06 98 76 54 32",
            "transition": {
              "type": "fade",
              "duration": 20
            }
          }
        }
      ]
    }
  }'
```

### Exemple 3 — Effet BEFORE\_AFTER avec deux images

```bash theme={null}
curl --request POST \
  --url 'https://iacrea.com/api/video-editor/generate/video' \
  --header 'x-api-key: VOTRE_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "video": {
      "format": "landscape",
      "template": "BeforeAfter",
      "font": "Inter",
      "colors": ["#0a0a0a", "#ffffff"],
      "displayLogo": true,
      "logoUrl": "https://exemple.com/logo.png",
      "sequences": [
        {
          "order": 0,
          "duration": 3,
          "type": "intro",
          "animationType": "fade",
          "medias": [],
          "data": {
            "description": "Transformation intérieure",
            "displayLogo": true
          }
        },
        {
          "order": 1,
          "duration": 5,
          "type": "video",
          "animationType": "BEFORE_AFTER_INTERIOR",
          "medias": [
            {
              "url": "https://exemple.com/salon-vide.jpg",
              "start": 0,
              "end": 5,
              "order": 0,
              "selected": true
            }
          ],
          "data": {
            "afterImage": "https://exemple.com/salon-meuble.jpg",
            "description": "Salon avant et après staging"
          }
        },
        {
          "order": 2,
          "duration": 5,
          "type": "video",
          "animationType": "BEFORE_AFTER_EXTERIOR",
          "medias": [
            {
              "url": "https://exemple.com/jardin-avant.jpg",
              "start": 0,
              "end": 5,
              "order": 0,
              "selected": true
            }
          ],
          "data": {
            "afterImage": "https://exemple.com/jardin-apres.jpg",
            "description": "Jardin avant et après aménagement",
            "transition": {
              "type": "wipe",
              "duration": 30
            }
          }
        },
        {
          "order": 3,
          "duration": 5,
          "type": "video",
          "animationType": "BEFORE_AFTER_DECLUTTER",
          "medias": [
            {
              "url": "https://exemple.com/chambre-encombrée.jpg",
              "start": 0,
              "end": 5,
              "order": 0,
              "selected": true
            }
          ],
          "data": {
            "afterImage": "https://exemple.com/chambre-vide.jpg",
            "description": "Chambre avant et après débarras",
            "transition": {
              "type": "iris",
              "duration": 25
            }
          }
        },
        {
          "order": 4,
          "duration": 5,
          "type": "video",
          "animationType": "BEFORE_AFTER_RENOVATION",
          "medias": [
            {
              "url": "https://exemple.com/pièce-à-rénover.jpg",
              "start": 0,
              "end": 5,
              "order": 0,
              "selected": true
            }
          ],
          "data": {
            "afterImage": "https://exemple.com/pièce-rénovée.jpg",
            "description": "Rénovation complète avec équipe",
            "transition": {
              "type": "fade",
              "duration": 20
            }
          }
        },
        {
          "order": 5,
          "duration": 5,
          "type": "outro",
          "animationType": "fade",
          "medias": [],
          "data": {
            "avatar": "https://exemple.com/photo-agent.jpg",
            "name": "Sophie Bernard",
            "email": "sophie@agence.fr",
            "tel": "06 11 22 33 44",
            "displayLogo": true
          }
        }
      ]
    }
  }'
```

### Exemple 4 — Logo masqué sur l'intro mais visible sur les séquences

```bash theme={null}
curl --request POST \
  --url 'https://iacrea.com/api/video-editor/generate/video' \
  --header 'x-api-key: VOTRE_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "video": {
      "format": "square",
      "template": "SaleProperty",
      "font": "Inter",
      "colors": ["#2d3436", "#dfe6e9"],
      "displayLogo": true,
      "logoUrl": "https://exemple.com/logo.png",
      "sequences": [
        {
          "order": 0,
          "duration": 3,
          "type": "intro",
          "animationType": "fade",
          "medias": [],
          "data": {
            "description": "Découvrez ce bien d exception",
            "displayLogo": false,
            "bg": "#000000"
          }
        },
        {
          "order": 1,
          "duration": 5,
          "type": "video",
          "animationType": "AUTO_EFFECTS",
          "medias": [
            {
              "url": "https://exemple.com/piscine.jpg",
              "start": 0,
              "end": 5,
              "order": 0,
              "selected": true
            }
          ]
        },
        {
          "order": 2,
          "duration": 5,
          "type": "outro",
          "animationType": "fade",
          "medias": [],
          "data": {
            "name": "Pierre Leroy",
            "email": "pierre@luxe-immo.fr",
            "tel": "06 00 00 00 00",
            "displayLogo": true,
            "bg": "#000000"
          }
        }
      ]
    }
  }'
```

## Réponse type

```json theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "generatedContent": [
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "url": "https://exemple.com/salon.jpg",
      "effect": "CAMERA_PUSH_IN",
      "format": "landscape",
      "status": "pending"
    },
    {
      "id": "660e8400-e29b-41d4-a716-446655440002",
      "url": "https://exemple.com/chambre.jpg",
      "effect": "CAMERA_PUSH_OUT",
      "format": "landscape",
      "status": "pending"
    }
  ],
  "creditsTotal": 48,
  "creditsUsed": 2
}
```

## Notes importantes

* Les séquences `"video"` déclenchent automatiquement la génération d'une animation IA à partir de l'image fournie. **Chaque séquence vidéo consomme 1 crédit.**
* La durée maximale d'une séquence `"video"` est **5 secondes** (plafonnée automatiquement).
* Les séquences `"intro"` et `"outro"` ne consomment pas de crédits (pas de génération IA).
* Utilisez l'`id` retourné avec `GET /api/video-editor/generate/video/{id}` pour suivre l'avancement.
* Si un webhook est fourni, vous recevrez une notification lorsque la vidéo finale est prête.

### Récapitulatif Intro / Outro

| Propriété | Intro | Outro (SaleProperty) | Outro (Interview/Sample) |
| - | - | - | - |
| `data.description` | Texte de présentation | — | Description |
| `data.displayLogo` | Afficher le logo centré | Afficher le logo centré | Afficher le logo centré |
| `data.bg` | Couleur de fond | Couleur de fond | Couleur de fond |
| `data.avatar` | — | Photo de profil | — |
| `data.displayAvatar` | — | Afficher l'avatar | — |
| `data.name` | — | Nom | — |
| `data.email` | — | Email | — |
| `data.tel` | — | Téléphone | — |
| `data.title` | — | — | Titre |

### Récapitulatif Transitions

Les transitions sont optionnelles. Sans transition définie, le passage entre séquences
utilise la transition par défaut du template (fondu de \~20 frames). Pour personnaliser,
ajoutez `data.transition` sur chaque séquence souhaitée.

| Type | Description |
| - | - |
| `fade` | Fondu enchaîné classique |
| `wipe` | Balayage horizontal |
| `slide` | Glissement latéral |
| `flip` | Retournement 3D |
| `clock-wipe` | Balayage en mouvement d'horloge |
| `iris` | Ouverture circulaire depuis le centre |
| `none` | Coupe franche (pas de transition) |

### Récapitulatif Before/After

| animationType | Description | Image "avant" | Image "après" |
| - | - | - | - |
| `BEFORE_AFTER_INTERIOR` | Meublage progressif | `medias[0].url` | `data.afterImage` |
| `BEFORE_AFTER_EXTERIOR` | Aménagement paysager | `medias[0].url` | `data.afterImage` |
| `BEFORE_AFTER_DECLUTTER` | Débarras (meubles disparaissent) | `medias[0].url` | `data.afterImage` |
| `BEFORE_AFTER_RENOVATION` | Rénovation (timelapse équipe) | `medias[0].url` | `data.afterImage` |

### Récapitulatif Logo

| Contexte | Paramètre | Taille | Position |
| - | - | - | - |
| Séquence `video`/`image` | `video.displayLogo` + `video.logoUrl` | 100 px | Coin supérieur droit |
| Séquence `intro` | `sequence.data.displayLogo` + `video.logoUrl` | 200 px | Centré |
| Séquence `outro` | `sequence.data.displayLogo` + `video.logoUrl` | 150 px | Centré |


# API Vidéo - Récupération
Source: https://docs.iacrea.com/api-reference/endpoint/video_get

Récupérer le statut et l'URL d'une vidéo en cours de génération

# API Vidéo - Récupération

Récupère le statut d'une vidéo en cours de génération et déclenche automatiquement les étapes suivantes (génération des clips, rendu final). Ce endpoint est **idempotent** et peut être appelé régulièrement pour suivre l'avancement.

<ParamField />

## Authentification

Toutes les requêtes doivent inclure l'en-tête :

* `x-api-key: VOTRE_API_KEY`

## En-têtes

<ParamField type="string">
  Votre clé API IACrea
</ParamField>

## Paramètres d'URL

<ParamField type="string">
  Identifiant unique de la vidéo (retourné par `POST
      /api/video-editor/generate/video`)
</ParamField>

## Réponses

Ce endpoint renvoie différents statuts selon l'avancement de la génération :

### 200 — `status: "GENERATING_VIDEO"`

Les clips vidéo (séquences) sont en cours de génération.

<ResponseField name="status" type="string">
  Statut : `"GENERATING_VIDEO"`
</ResponseField>

<ResponseField name="creditsTotal" type="number">
  Nombre de crédits vidéo restants
</ResponseField>

<ResponseField name="creditsUsed" type="number">
  Nombre de crédits utilisés
</ResponseField>

<ResponseField name="generatedContent" type="array">
  Liste des contenus générés avec leur statut actuel (`"pending" | "success" |
      "error"`)
</ResponseField>

### 200 — `status: "START_RENDERING_VIDEO"`

Toutes les séquences sont prêtes et le rendu final de la vidéo démarre.

<ResponseField name="status" type="string">
  Statut : `"START_RENDERING_VIDEO"`
</ResponseField>

<ResponseField name="progress" type="number">
  Progression du rendu (0 au démarrage)
</ResponseField>

<ResponseField name="creditsTotal" type="number">
  Nombre de crédits vidéo restants
</ResponseField>

<ResponseField name="creditsUsed" type="number">
  Nombre de crédits utilisés
</ResponseField>

<ResponseField name="generatedContent" type="array">
  Liste des contenus générés
</ResponseField>

### 200 — `status: "RENDERING_VIDEO"`

Le rendu final de la vidéo est en cours.

<ResponseField name="status" type="string">
  Statut : `"RENDERING_VIDEO"`
</ResponseField>

<ResponseField name="progress" type="number">
  Progression du rendu (nombre entre 0 et 1, ou 0-100 selon l'implémentation)
</ResponseField>

<ResponseField name="creditsTotal" type="number">
  Nombre de crédits vidéo restants
</ResponseField>

<ResponseField name="creditsUsed" type="number">
  Nombre de crédits utilisés
</ResponseField>

### 200 — `status: "DONE"`

La vidéo finale est prête et disponible.

<ResponseField name="status" type="string">
  Statut : `"DONE"`
</ResponseField>

<ResponseField name="url" type="string">
  URL de la vidéo finale générée
</ResponseField>

<ResponseField name="id" type="string">
  Identifiant de la vidéo
</ResponseField>

<ResponseField name="generatedContent" type="array">
  Liste des contenus générés avec leur statut final
</ResponseField>

<ResponseField name="creditsTotal" type="number">
  Nombre de crédits vidéo restants
</ResponseField>

<ResponseField name="creditsUsed" type="number">
  Nombre de crédits utilisés
</ResponseField>

### 200 — `status: "PENDING"`

État transitoire. Peut être renvoyé lorsqu'une séquence est en erreur et qu'une régénération est relancée automatiquement côté serveur.

<ResponseField name="status" type="string">
  Statut : `"PENDING"`
</ResponseField>

<ResponseField name="error" type="string">
  Message d'erreur optionnel (ex : `"Re-generating video in error"`)
</ResponseField>

### 401 — Non autorisé

Renvoyé si `x-api-key` est manquant ou invalide.

### 404 — Non trouvé

Renvoyé si l'`id` de la vidéo n'existe pas.

### 500 — Erreur serveur

Erreur interne du serveur.

## Exemple de requête

```bash theme={null}
curl --request GET \
  --url 'https://iacrea.com/api/video-editor/generate/video/550e8400-e29b-41d4-a716-446655440000' \
  --header 'x-api-key: VOTRE_API_KEY'
```

## Exemples de réponses

### Génération en cours

```json theme={null}
{
  "status": "GENERATING_VIDEO",
  "creditsTotal": 48,
  "creditsUsed": 2,
  "generatedContent": [
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "url": "https://exemple.com/image1.jpg",
      "effect": "CAMERA_PUSH_IN",
      "format": "landscape",
      "status": "success"
    },
    {
      "id": "660e8400-e29b-41d4-a716-446655440002",
      "url": "https://exemple.com/image2.jpg",
      "effect": "CAMERA_PUSH_OUT",
      "format": "landscape",
      "status": "pending"
    }
  ]
}
```

### Rendu en cours

```json theme={null}
{
  "status": "RENDERING_VIDEO",
  "progress": 0.65,
  "creditsTotal": 48,
  "creditsUsed": 2
}
```

### Vidéo terminée

```json theme={null}
{
  "status": "DONE",
  "url": "https://storage.iacrea.com/videos/550e8400-e29b-41d4-a716-446655440000.mp4",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "generatedContent": [
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "url": "https://exemple.com/image1.jpg",
      "effect": "CAMERA_PUSH_IN",
      "format": "landscape",
      "status": "success"
    },
    {
      "id": "660e8400-e29b-41d4-a716-446655440002",
      "url": "https://exemple.com/image2.jpg",
      "effect": "CAMERA_PUSH_OUT",
      "format": "landscape",
      "status": "success"
    }
  ],
  "creditsTotal": 48,
  "creditsUsed": 2
}
```

## Recommandations d'intégration

* **Polling** : Appelez ce endpoint toutes les **2-5 secondes** jusqu'à obtenir le statut `"DONE"` ou `"ERROR"`
* **Timeout** : Prévoyez un timeout côté client (ex : 10-20 minutes) selon la durée de rendu
* **Résilience** : Si vous recevez `"PENDING"` après avoir déjà vu `"GENERATING_VIDEO"`, continuez le polling : le serveur peut relancer automatiquement des séquences en erreur
* **Webhook** : Si vous avez fourni un `webhookUrl` lors de la création, vous recevrez également une notification lorsque la vidéo est prête


# API Vidéo - Régénération de séquence
Source: https://docs.iacrea.com/api-reference/endpoint/video_sequence

Régénérer une séquence spécifique d'une vidéo

# API Vidéo - Régénération de séquence

Régénère une séquence spécifique d'une vidéo existante. Utile pour corriger une séquence en erreur ou changer l'animation d'une séquence particulière.

<ParamField />

## Authentification

Toutes les requêtes doivent inclure l'en-tête :

* `x-api-key: VOTRE_API_KEY`

## En-têtes

<ParamField type="string">
  Votre clé API IACrea
</ParamField>

<ParamField type="string">
  Doit être `application/json`
</ParamField>

## Paramètres d'URL

<ParamField type="string">
  Identifiant unique de la vidéo (retourné par `POST
      /api/video-editor/generate/video`)
</ParamField>

## Corps de requête

<ParamField type="string">
  Identifiant de la séquence à régénérer (retrouvable dans `generatedContent` de
  la réponse de `GET /api/video-editor/generate/video/{id}`)
</ParamField>

<ParamField type="object">
  Paramètres optionnels pour la nouvelle génération
</ParamField>

<ParamField type="string">
  Nouvelle URL d'image à utiliser (si différente de l'originale). Optionnel.
</ParamField>

<ParamField type="string">
  Nouveau type d'animation à utiliser. Optionnel.
</ParamField>

## Réponses

### 200 — Régénération démarrée

<ResponseField name="status" type="string">
  Statut : `"START_GENERATION"`
</ResponseField>

<ResponseField name="generationId" type="string">
  Identifiant de la nouvelle génération pour cette séquence
</ResponseField>

<ResponseField name="creditsTotal" type="number">
  Nombre de crédits vidéo restants
</ResponseField>

<ResponseField name="creditsUsed" type="number">
  Nombre de crédits utilisés
</ResponseField>

### 400 — Erreur de validation

Renvoyé si l'`id` de la vidéo ou le `sequenceId` est invalide.

### 401 — Non autorisé

Renvoyé si `x-api-key` est manquant ou invalide.

### 404 — Non trouvé

Renvoyé si la vidéo ou la séquence n'existe pas.

### 500 — Erreur serveur

Erreur interne du serveur.

## Exemple de requête

```bash theme={null}
curl --request POST \
  --url 'https://iacrea.com/api/video-editor/generate/sequence/550e8400-e29b-41d4-a716-446655440000' \
  --header 'x-api-key: VOTRE_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "sequenceId": "660e8400-e29b-41d4-a716-446655440001",
    "sequence": {
      "url": "https://exemple.com/nouvelle-image.jpg",
      "effect": "CAMERA_PUSH_OUT"
    }
  }'
```

## Exemple de réponse

```json theme={null}
{
  "status": "START_GENERATION",
  "generationId": "770e8400-e29b-41d4-a716-446655440003",
  "creditsTotal": 47,
  "creditsUsed": 3
}
```

## Notes importantes

* La régénération d'une séquence réinitialise le statut de la vidéo à `"pending"` et annule le rendu final s'il était en cours
* Vous devrez utiliser `GET /api/video-editor/generate/video/{id}` pour suivre l'avancement de la nouvelle génération
* Si vous ne fournissez pas `sequence.url` ou `sequence.effect`, les valeurs originales seront réutilisées
* La régénération consomme des crédits vidéo supplémentaires


# Introduction à l'API
Source: https://docs.iacrea.com/api-reference/introduction

Transformez les espaces vides en intérieurs chaleureux et accueillants grâce à notre service en marque blanche.

# API IACrea

L'API IACrea vous permet d'intégrer nos puissants services de transformation d'images directement dans vos applications, sites web et workflows.

## Pré-requis

* Afin d'utiliser nos services d'API, il est nécessaire de créer un compte IACrea et d'activer l'offre API en nous contactant : [contact@iacrea.com](mailto:contact@iacrea.com)
* Générez votre API key directement dans votre Espace Développeur.
* Chaque requête API doit être authentifiée à l'aide d'une API key. Veuillez inclure dans le header de toutes vos requêtes :

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

## Format des requêtes

Les requêtes doivent être envoyées au format JSON. Chaque endpoint nécessite des paramètres spécifiques détaillés dans sa documentation.

## Format des réponses

Les réponses sont retournées au format JSON avec une structure cohérente selon le type d'opération.

## Gestion des erreurs

En cas d'erreur, l'API retourne un code d'état HTTP approprié et un message d'erreur explicatif.

**Note importante:** En cas de statut "FAILED", vos photos sont automatiquement remboursées.

## Services disponibles

Notre API propose plusieurs endpoints correspondant aux différents services d'IA:

* [Crédits](/api-reference/endpoint/credit) - Consultation de vos crédits disponibles
* [Vidéo](/api-reference/endpoint/video) - Création de vidéos immobilières
* [Rénovation](/api-reference/endpoint/renovate) - Visualisation d'espaces rénovés
* [Ameublement](/api-reference/endpoint/furnish) - Ameublement d'espaces vides
* [Aménagement extérieur](/api-reference/endpoint/exterior) - Transformation de l'apparence extérieure
* [Suppression d'éléments](/api-reference/endpoint/declutter) - Suppression d'objets indésirables
* [Ciel bleu](/api-reference/endpoint/sky) - Obtention d'un ciel bleu
* [Ciel intérieur](/api-reference/endpoint/sky_interior) - Amélioration de la luminosité intérieure
* [Plan 3D](/api-reference/endpoint/plan) - Génération à partir d'un plan 3D
* [Modification d'élément](/api-reference/endpoint/one_element) - Modification d'un élément spécifique
* [Suppression de logo](/api-reference/endpoint/remove_logo) - Suppression de logos
* [Création de pièce](/api-reference/endpoint/create_room) - Création d'une pièce
* [Création d'extérieur](/api-reference/endpoint/create_exterior) - Création d'un espace extérieur

## Mode de fonctionnement

1. Vous envoyez une requête à notre API pour générer une transformation
2. La génération s'exécute en asynchrone (peut prendre plusieurs minutes)
3. Vous récupérez le résultat soit par webhook, soit en interrogeant l'API de récupération


# Création d'Extérieur
Source: https://docs.iacrea.com/features/create_exterior

Transformez des espaces extérieurs existants en nouvelles visualisations

# Création d'Extérieur

Notre service de Création d'Extérieur vous permet de transformer des zones spécifiques d'une image en espaces extérieurs entièrement nouveaux et photoréalistes.

## Fonctionnement

Notre IA génère des visualisations d'extérieurs en :

* Analysant l'image source et la zone à transformer (définie par un masque)
* Créant des terrasses, piscines ou terrains de pétanque selon vos besoins
* Adaptant le style pour qu'il s'intègre harmonieusement avec le reste de l'image
* Produisant des résultats photoréalistes de haute qualité

## Cas d'usage

* Visualisation de projets d'aménagement paysager avant la réalisation
* Présentation de concepts à des clients (terrasses, piscines, etc.)
* Transformation virtuelle d'espaces extérieurs existants
* Études de faisabilité pour des projets immobiliers

## API

Intégrez cette fonctionnalité dans vos applications avec notre API simple et puissante.

### Générer un extérieur

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

### Générer une variation

Vous pouvez créer des variations à partir d'une génération précédente :

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

### Récupérer les résultats

Obtenez les résultats d'une génération :

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

## Conseils d'utilisation

* Fournissez des images claires avec une bonne résolution
* Créez un masque précis qui délimite uniquement la zone à transformer
* Choisissez le type d'extérieur adapté à votre projet : TERRACE, POOL, PETANQUE
* Générez plusieurs variations pour explorer différentes possibilités
* Pour des résultats optimaux, assurez-vous que l'angle de prise de vue est approprié pour le type d'extérieur souhaité


# Création de Pièce
Source: https://docs.iacrea.com/features/create_room

Générez des intérieurs complets à partir d'instructions

# Création de Pièce

Créez des visualisations d'intérieurs entièrement nouveaux à partir de simples descriptions textuelles, sans photo préalable.

## Fonctionnement

Notre IA génère des intérieurs complets en :

* Interprétant vos descriptions textuelles
* Créant des espaces avec perspective et éclairage réalistes
* Meublant et décorant selon le style choisi
* Ajustant les finitions et matériaux

## Cas d'usage

* Visualisation conceptuelle pour designers d'intérieur
* Présentation de projets de décoration
* Inspiration pour aménagements d'espaces
* Marketing immobilier pour projets en développement

## API

Intégrez cette fonctionnalité dans vos applications :

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/create_room/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "image_url": "https://exemple.com/image.jpg",
  "mask_url": "https://exemple.com/masque.png",
  "room_type": "KITCHEN",
  "theme": "MODERN",
  "width": 1024,
  "height": 768
}'
```

### Générer une variation

Vous pouvez également créer des variations à partir d'une génération précédente :

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/create_room/generate-variation' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "generation_id": "id-de-generation-precedente",
  "original_url": "https://exemple.com/image.jpg",
  "mask_url": "https://exemple.com/masque.png",
  "room_type": "BATHROOM",
  "theme": "SCANDINAVIAN"
}'
```

### Récupérer les résultats

Obtenez les résultats d'une génération :

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

## Conseils

* Utilisez les types de pièces disponibles : KITCHEN, BATHROOM, SHOWEROOM
* Choisissez parmi les thèmes disponibles : MODERN, INDUSTRIAL, SCANDINAVIAN, LUXURIOUS
* Créez un masque qui indique clairement la zone où la pièce doit être générée
* Essayez différentes combinaisons de types de pièces et de thèmes


# Désencombrement
Source: https://docs.iacrea.com/features/declutter

Supprimez les objets indésirables de vos photos

# Désencombrement

Nettoyez virtuellement vos espaces en supprimant automatiquement les objets indésirables pour des photos immobilières plus attrayantes.

## Fonctionnement

Notre IA identifie et supprime les éléments perturbateurs :

* Objets personnels
* Désordre visuel
* Éléments distractifs
* Petits meubles encombrants

## Cas d'usage

* Photos immobilières épurées pour les annonces
* Mise en valeur des espaces avant visites
* Préparation d'images pour le home staging virtuel
* Nettoyage visuel avant d'appliquer d'autres transformations

## API

Intégrez cette fonctionnalité dans vos applications :

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/declutter_total/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "image_url": "https://exemple.com/image.jpg",
  "auto": true
}'
```

### Générer une variation

Vous pouvez également créer des variations à partir d'une génération précédente :

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/declutter_total/generate-variation' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "generation_id": "id-de-generation-precedente",
  "original_url": "https://exemple.com/image.jpg",
  "mask_url": "https://exemple.com/nouveau-masque.png"
}'
```

### Récupérer les résultats

Obtenez les résultats d'une génération :

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

## Conseils

* Utilisez des photos bien éclairées pour de meilleurs résultats
* Pour les objets complexes, précisez ce que vous souhaitez supprimer en utilisant un masque
* Combinez avec d'autres fonctionnalités pour un résultat optimal
* Utilisez l'option "auto" pour une détection automatique des objets à supprimer


# Aménagement Extérieur v3
Source: https://docs.iacrea.com/features/exterior

Transformez l'apparence des bâtiments et jardins avec des options personnalisées

# Aménagement Extérieur v3

Modifiez virtuellement l'aspect extérieur des bâtiments et espaces verts avec des options personnalisées avancées pour visualiser différentes options de rénovation.

## Fonctionnement

Notre IA v3 transforme les extérieurs en appliquant :

* Options personnalisées selon vos instructions
* Aménagements paysagers adaptés
* Éléments extérieurs spécifiques (piscine, barbecue, mobilier)
* Couleurs et textures personnalisées
* Génération automatique intelligente

## Cas d'usage

* Visualisation de projets de rénovation extérieure avec éléments spécifiques
* Présentation du potentiel d'une propriété avec aménagements personnalisés
* Test de différents styles et éléments avant travaux
* Marketing immobilier amélioré avec options sur mesure
* Aménagement de jardins et terrasses selon vos besoins

## Options personnalisées

La v3 vous permet de spécifier exactement ce que vous souhaitez ajouter :

* **Piscine** : "Ajouter une piscine moderne"
* **Barbecue** : "Installer un barbecue extérieur"
* **Mobilier** : "Ajouter du mobilier de jardin"
* **Plantes** : "Enrichir avec des plantes tropicales"
* **Terrasse** : "Créer une terrasse en bois"
* **Éclairage** : "Ajouter un éclairage extérieur"

Vous pouvez combiner plusieurs éléments : `"Ajouter une piscine avec terrasse en bois, installer un barbecue moderne et des plantes tropicales"`

## API

Intégrez cette fonctionnalité dans vos applications :

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/exterior/v3/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "image_url": "https://exemple.com/exterieur.jpg",
  "options": "Ajouter une piscine avec terrasse en bois, installer un barbecue moderne"
}'
```

## Conseils

* Utilisez des photos prises avec un angle frontal ou légèrement décalé
* Soyez précis dans vos instructions pour de meilleurs résultats
* Testez différents aménagements pour valoriser la propriété
* Les options sont facultatives - vous pouvez générer automatiquement
* Combinez plusieurs éléments pour des résultats plus riches


# Ameublement
Source: https://docs.iacrea.com/features/furnish

Meublez virtuellement vos espaces vides

# Ameublement

Transformez vos espaces vides en intérieurs parfaitement meublés et décorés, sans aucun meuble réel.

## Fonctionnement

Notre IA ajoute du mobilier virtuel à votre espace en :

* Respectant les proportions et la perspective
* Adaptant l'ameublement au style choisi
* Créant des ambiances cohérentes et réalistes

## Cas d'usage

* Home staging virtuel pour valoriser un bien immobilier
* Visualisation de différentes options d'aménagement
* Présentation de propriétés vides comme meublées
* Projection du résultat final d'un espace rénové

## API

Intégrez cette fonctionnalité dans vos applications :

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/furnish/v4/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "image_url": "https://exemple.com/espace-vide.jpg",
  "theme": "MODERN",
  "room_type": "LIVING_ROOM",
  "generation_mode": "creative"
}'
```

## Conseils

* Utilisez des photos prises avec un angle large montrant l'ensemble de la pièce
* Spécifiez clairement le style souhaité (moderne, scandinave, bord de mer, etc.)
* Expérimentez avec différentes variations pour trouver l'aménagement idéal


# Élément Ciblé
Source: https://docs.iacrea.com/features/one_element

Transformez un élément spécifique d'une image

# Élément Ciblé

Modifiez un élément précis de votre image tout en préservant le reste de la composition intacte.

## Fonctionnement

Notre IA transforme des éléments ciblés en :

* Isolant précisément la zone à modifier
* Remplaçant l'élément sélectionné selon vos instructions
* Intégrant harmonieusement le nouvel élément
* Préservant l'éclairage et la perspective

## Cas d'usage

* Changement de couleur des murs ou du sol
* Remplacement de meubles spécifiques
* Modification de finitions ou matériaux
* Test de variations d'éléments décoratifs

## API

Intégrez cette fonctionnalité dans vos applications :

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/one_element/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "image_url": "https://exemple.com/image.jpg",
  "element": "WALL"
}'
```

### Générer une variation

Vous pouvez également créer des variations à partir d'une modification précédente :

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/one_element/generate-variation' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "generation_id": "id-de-generation-precedente",
  "room_type": "FLOOR"
}'
```

### Récupérer les résultats

Obtenez les résultats d'une génération :

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

## Conseils

* Utilisez les valeurs prédéfinies pour l'élément à modifier (WALL, FLOOR, etc.)
* Pour les transformations complexes, essayez différentes variations
* Les éléments bien définis et distincts donnent les meilleurs résultats
* Essayez différents types d'éléments si le résultat initial ne vous satisfait pas


# Plan 3D
Source: https://docs.iacrea.com/features/plan

Transformez vos plans 2D en visualisations 3D

# Plan 3D

Convertissez vos plans 2D en visualisations réalistes d'espaces habités, permettant de voir le résultat final avant construction.

## Fonctionnement

Notre IA analyse votre plan 2D et génère une représentation 3D en :

* Interprétant la disposition des pièces
* Appliquant le style et les finitions choisis
* Ajoutant mobilier et décoration cohérents

## Cas d'usage

* Présentation de projets immobiliers sur plan
* Visualisation de différentes options d'aménagement
* Communication claire avec clients ou investisseurs
* Marketing immobilier avant construction

## API

Intégrez cette fonctionnalité dans vos applications :

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/plan/v2/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "image_url": "https://exemple.com/plan.jpg",
  "theme": "MODERN",
  "style_image_url": "https://exemple.com/style.jpg"
}'
```

### Générer une variation

Vous pouvez également créer des variations à partir d'une génération précédente :

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/plan/v2/generate-variation' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "generation_id": "id-de-generation-precedente",
  "theme": "SCANDINAVIAN",
  "style_image_url": "https://exemple.com/style.jpg"
}'
```

### Récupérer les résultats

Obtenez les résultats d'une génération :

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

## Conseils

* Utilisez des plans clairs avec des lignes bien définies
* Pour les plans complexes, traitez chaque pièce séparément
* Précisez le type de pièce pour obtenir un aménagement approprié
* Essayez différents thèmes pour visualiser diverses options d'aménagement


# Suppression de Logo
Source: https://docs.iacrea.com/features/remove_logo

Effacez les logos et filigranes de vos images

# Suppression de Logo

Retirez proprement les logos, filigranes ou inscriptions de vos images immobilières.

## Fonctionnement

Notre IA supprime les logos en :

* Détectant précisément la zone du logo
* Reconstruisant intelligemment la zone effacée
* Préservant la continuité des textures et détails
* Conservant la qualité originale de l'image

## Cas d'usage

* Nettoyage d'images pour présentation professionnelle
* Suppression de filigranes d'agences
* Préparation d'images pour marketing
* Élimination d'éléments de branding non désirés

## API

Intégrez cette fonctionnalité dans vos applications :

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/remove_logo/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "image_url": "https://exemple.com/image-avec-logo.jpg",
  "mask_url": "https://exemple.com/masque-du-logo.png"
}'
```

### Générer une variation

Vous pouvez également créer des variations à partir d'une suppression précédente :

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/remove_logo/generate-variation' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "generation_id": "id-de-generation-precedente",
  "original_url": "https://exemple.com/image-avec-logo.jpg",
  "mask_url": "https://exemple.com/nouveau-masque.png"
}'
```

### Récupérer les résultats

Obtenez les résultats d'une génération :

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

## Conseils

* Fournissez des images avec une résolution suffisante
* Créez un masque précis qui indique clairement la zone du logo à supprimer
* La fonctionnalité fonctionne mieux pour les logos aux contours bien définis
* Utilisez l'endpoint de variation pour affiner les résultats si nécessaire


# Rénovation
Source: https://docs.iacrea.com/features/renovate

Visualisez vos espaces après rénovation

# Rénovation

Transformez virtuellement vos espaces intérieurs pour visualiser les résultats d'une rénovation, sans réaliser les travaux.

## Fonctionnement

Notre IA transforme votre espace selon vos instructions :

* Changement des revêtements (sols, murs, plafonds)
* Modification des styles et matériaux
* Ajustement de l'agencement

## Cas d'usage

* Montrer le potentiel de rénovation d'un bien immobilier
* Présenter des concepts de design à vos clients
* Tester différentes options de rénovation avant travaux
* Créer des visuels attractifs pour vos projets

## API

Intégrez cette fonctionnalité dans vos applications :

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/renovate/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "image_url": "https://exemple.com/image.jpg",
  "theme": "MODERN",
  "room_type": "LIVING_ROOM"
}'
```

## Conseils

* Utilisez des photos bien éclairées montrant clairement l'espace
* Précisez le style souhaité pour de meilleurs résultats
* Essayez plusieurs variations pour explorer différentes options


# Ciel Bleu
Source: https://docs.iacrea.com/features/sky

Remplacez un ciel gris par un ciel bleu éclatant

# Ciel Bleu

Transformez automatiquement vos ciels gris ou nuageux en ciels bleus parfaits pour améliorer l'attrait de vos photos extérieures.

## Fonctionnement

Notre IA détecte intelligemment le ciel dans votre image et le remplace par un ciel bleu naturel, tout en préservant tous les détails du premier plan.

## Cas d'usage

* Photos immobilières plus attrayantes pour les annonces
* Images cohérentes pour les portfolios d'architecture
* Valorisation des propriétés et paysages extérieurs
* Photos de qualité sans attendre la météo idéale

## API

Intégrez cette fonctionnalité dans vos applications :

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

### Générer une variation

Vous pouvez également créer des variations à partir d'une génération précédente :

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

### Récupérer les résultats

Obtenez les résultats d'une génération :

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

## Conseils

* Privilégiez les photos où le ciel est clairement visible
* Pour les zones complexes (arbres, structures fines), utilisez des images haute résolution
* Testez différentes variations pour obtenir le résultat optimal
* Le processus utilise plusieurs ciels bleus naturels pour des résultats variés


# Ciel Intérieur
Source: https://docs.iacrea.com/features/sky_interior

Améliorez la vue depuis vos fenêtres intérieures

# Ciel Intérieur

Transformez la vue depuis les fenêtres de vos intérieurs en ajoutant un ciel bleu éclatant et des paysages attractifs.

## Fonctionnement

Notre IA optimise les vues extérieures en :

* Identifiant automatiquement les fenêtres dans l'image
* Remplaçant le ciel visible par un ciel bleu parfait
* Améliorant l'aspect des paysages visibles
* Préservant la luminosité naturelle de l'intérieur

## Cas d'usage

* Valorisation de la luminosité des espaces intérieurs
* Amélioration des photos par temps gris ou nuageux
* Mise en valeur des vues depuis les fenêtres
* Création d'ambiances plus accueillantes

## API

Intégrez cette fonctionnalité dans vos applications :

```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": "votre-user-id",
  "image_url": "https://exemple.com/interieur-avec-fenetre.jpg"
}'
```

### Générer une variation

Vous pouvez également créer des variations à partir d'une génération précédente :

```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": "votre-user-id",
  "generation_id": "id-de-generation-precedente"
}'
```

### Récupérer les résultats

Obtenez les résultats d'une génération :

```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": "votre-user-id",
  "generation_id": "votre-generation-id"
}'
```

## Conseils

* Utilisez des photos où les fenêtres sont clairement visibles
* Pour les meilleures transformations, privilégiez les fenêtres dégagées
* L'effet est optimal pour les grandes baies vitrées ou fenêtres panoramiques
* Essayez plusieurs variations pour obtenir le meilleur résultat possible


# Vidéo
Source: https://docs.iacrea.com/features/video

Créez des animations à partir de vos images

# Vidéo

Transformez vos images statiques en vidéos animées pour présenter vos espaces de manière dynamique et immersive.

## Fonctionnement

Notre IA convertit vos images en séquences vidéo en :

* Ajoutant des mouvements de caméra fluides
* Créant une profondeur 3D à partir d'images 2D
* Simulant des déplacements dans l'espace
* Maintenant une haute qualité visuelle

## Cas d'usage

* Visites virtuelles animées pour l'immobilier
* Présentations plus engageantes de projets architecturaux
* Contenus interactifs pour réseaux sociaux
* Mise en valeur dynamique d'espaces rénovés

## API

Intégrez cette fonctionnalité dans vos applications :

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/animation/v2/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "image_urls": ["https://exemple.com/image.jpg"],
  "option": "ZOOM_OUT",
  "prompt": "Élégant salon moderne",
  "format": "mp4"
}'
```

### Options d'animation disponibles

Les valeurs possibles pour le paramètre `option` sont :

* `ZOOM_IN` : Effet de zoom avant vers l'intérieur de l'image
* `ZOOM_OUT` : Effet de zoom arrière s'éloignant de l'image
* `PAN_RIGHT` : Déplacement de la caméra vers la droite
* `PAN_LEFT` : Déplacement de la caméra vers la gauche
* `PAN_UP` : Déplacement de la caméra vers le haut
* `PAN_DOWN` : Déplacement de la caméra vers le bas
* `CAMERA_PUSH_OUT` : Mouvement fluide combinant zoom et déplacement
* `AUTO_EFFECTS` : Génération automatique du prompt par l'IA pour créer une animation optimale
* `AUTO_REVERSE` : Génération automatique du prompt par l'IA pour créer une animation en sens inverse

### Récupérer les résultats

Obtenez les résultats d'une génération vidéo :

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

La génération de vidéo prend généralement quelques minutes. Pendant le traitement, le statut retourné sera `STARTING` puis `PROCESSING`. Une fois complété, vous recevrez un statut `SUCCEEDED` avec l'URL de votre vidéo.

### Exemple de réponse réussie

```json theme={null}
{
  "status": "SUCCEEDED",
  "urls": ["https://url-de-votre-video.mp4"]
}
```

## Conseils

* Utilisez des images de haute qualité pour de meilleurs résultats
* Choisissez des photos avec une bonne profondeur visuelle
* Testez les différents types d'animation pour trouver l'effet le plus adapté à votre espace
* Utilisez le paramètre `prompt` pour guider le style visuel de l'animation
* Combinez avec nos autres services pour créer des visites virtuelles complètes


# Introduction
Source: https://docs.iacrea.com/introduction

IACrea - La solution professionnelle d'édition d'images par IA pour l'immobilier et l'architecture

# Bienvenue sur IACrea

IACrea est une plateforme de pointe qui utilise l'intelligence artificielle pour transformer des images immobilières et architecturales. Notre technologie s'adresse aux professionnels de l'immobilier, aux architectes, et aux designers d'intérieur qui souhaitent créer des visualisations attrayantes rapidement et à moindre coût.

## Nos services d'IA pour l'immobilier

Notre plateforme propose plusieurs fonctionnalités spécialisées pour le secteur immobilier :

<CardGroup>
  <Card title="Rénovation" icon="paint-roller">
    Transformez des espaces existants en présentant leur potentiel après rénovation
  </Card>

  <Card title="Ameublement" icon="couch">
    Ajoutez virtuellement des meubles aux espaces vides pour faciliter la projection
  </Card>

  <Card title="Aménagement extérieur" icon="tree">
    Améliorez l'apparence des façades et des jardins pour maximiser l'attrait
  </Card>

  <Card title="Désencombrement" icon="broom">
    Supprimez automatiquement les objets indésirables des photos immobilières
  </Card>

  <Card title="Ciel bleu" icon="sun">
    Remplacez un ciel nuageux par un ciel bleu éclatant sur vos photos extérieures
  </Card>

  <Card title="Plan 3D" icon="compass-drafting">
    Transformez des plans 2D en visualisations 3D réalistes et immersives
  </Card>
</CardGroup>

## Avantages clés

<CardGroup>
  <Card title="Gain de temps" icon="clock">
    Obtenez des résultats professionnels en quelques minutes au lieu de plusieurs heures
  </Card>

  <Card title="Réduction des coûts" icon="euro-sign">
    Économisez jusqu'à 90% par rapport aux services traditionnels de photographie et de design
  </Card>

  <Card title="Qualité professionnelle" icon="star">
    Générez des images de haute qualité adaptées aux standards du marché immobilier
  </Card>
</CardGroup>

## Solutions d'intégration

IACrea propose deux façons d'accéder à nos services :

### Interface utilisateur web

Accédez à toutes nos fonctionnalités via notre plateforme en ligne intuitive. Idéale pour les utilisateurs individuels et les équipes qui souhaitent transformer rapidement leurs images.

### API pour développeurs

Intégrez nos services directement dans vos applications et workflows grâce à notre API REST. Pour obtenir un accès à notre API, vous devez contacter notre équipe à [contact@iacrea.com](mailto:contact@iacrea.com). Une fois l'accès activé, vous pourrez générer votre clé API depuis votre Espace Développeur sur le site d'IACrea.

<Card title="Commencer avec l'API" icon="code" href="/api-reference/introduction">
  Consultez notre documentation API pour intégrer IACrea à vos applications
</Card>

## Pour commencer

<Steps>
  <Step title="Créez un compte">
    Inscrivez-vous sur [IACrea.com](https://iacrea.com) pour commencer
  </Step>

  <Step title="Contactez-nous pour l'API">
    Si vous souhaitez utiliser notre API, envoyez un email à [contact@iacrea.com](mailto:contact@iacrea.com) pour demander l'activation
  </Step>

  <Step title="Importez vos images">
    Téléchargez vos photos ou connectez notre API à votre application
  </Step>

  <Step title="Transformez vos espaces">
    Utilisez nos services d'IA pour créer des visualisations impressionnantes
  </Step>
</Steps>

Consultez notre [Guide de démarrage rapide](/quickstart) pour plus de détails sur la prise en main de notre plateforme.


# Guide de démarrage rapide
Source: https://docs.iacrea.com/quickstart

Intégrez IACrea à vos applications en quelques étapes simples

# Guide de démarrage rapide

Ce guide vous aidera à commencer rapidement avec IACrea et à intégrer notre API à vos applications. Pour accéder à notre API, vous devez obligatoirement contacter notre support à [contact@iacrea.com](mailto:contact@iacrea.com).

## Création de votre compte développeur

<Steps>
  <Step title="Inscrivez-vous">
    Rendez-vous sur [IACrea.com](https://iacrea.com) et créez votre compte en
    fournissant vos informations professionnelles.
  </Step>

  <Step title="Vérifiez votre email">
    Confirmez votre compte en cliquant sur le lien que nous vous envoyons par
    email.
  </Step>

  <Step title="Contactez notre support">
    Envoyez un email à [contact@iacrea.com](mailto:contact@iacrea.com) pour demander l'activation de l'accès
    API pour votre compte. Précisez votre cas d'utilisation et vos besoins
    spécifiques.
  </Step>

  <Step title="Accédez à votre Espace développeur">
    Une fois l'accès API activé par notre équipe, connectez-vous à votre compte
    et accédez à la section "Espace développeur" pour récupérer votre clé API.
  </Step>
</Steps>

<Note>
  L'accès à l'API est soumis à validation par notre équipe. Contactez-nous à
  [contact@iacrea.com](mailto:contact@iacrea.com) pour discuter de vos besoins spécifiques et obtenir les
  informations concernant les forfaits disponibles.
</Note>

## Configuration de votre environnement API

<Steps>
  <Step title="Récupérez votre clé API">
    Dans votre Espace Développeur sur le site d'IACrea, récupérez votre clé API unique. Cette clé doit rester confidentielle et ne pas être partagée.

    ```bash theme={null}
    # Exemple d'authentification avec votre clé API
    x-api-key: votre-clé-api
    ```
  </Step>

  <Step title="Testez la connexion">
    Vérifiez que votre configuration fonctionne en récupérant le nombre de photos restantes sur votre compte.

    ```bash theme={null}
    curl --request POST \
    --url 'https://iacrea.com/api/account/credit' \
    --header 'x-api-key: VOTRE_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
      "user_id": "votre-user-id"
    }'
    ```
  </Step>
</Steps>

## Intégration des services IACrea

Notre API offre plusieurs services que vous pouvez intégrer dans votre application :

<Tabs>
  <Tab title="Rénovation">
    ```bash theme={null}
    curl --request POST \
    --url 'https://iacrea.com/api/renovate/generate' \
    --header 'x-api-key: VOTRE_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
      "user_id": "votre-user-id",
      "image_url": "https://exemple.com/image.jpg",
      "theme": "MODERN",
      "room_type": "LIVING_ROOM",
      "photo_360": false
    }'
    ```
  </Tab>

  <Tab title="Ameublement">
    ```bash theme={null}
    curl --request POST \
    --url 'https://iacrea.com/api/furnish/v4/generate' \
    --header 'x-api-key: VOTRE_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
      "user_id": "votre-user-id",
      "image_url": "https://exemple.com/image.jpg",
      "theme": "MODERN",
      "room_type": "LIVING_ROOM",
      "generation_mode": "creative"
    }'
    ```
  </Tab>

  <Tab title="Ciel Bleu">
    ```bash theme={null}
    curl --request POST \
    --url 'https://iacrea.com/api/sky/generate' \
    --header 'x-api-key: VOTRE_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
      "user_id": "votre-user-id",
      "image_url": "https://exemple.com/image.jpg"
    }'
    ```
  </Tab>
</Tabs>

## Récupération des résultats

Comme nos services fonctionnent de manière asynchrone, vous avez deux options pour obtenir les résultats :

### Option 1 : Webhook (recommandé)

Fournissez une URL de webhook lors de l'appel initial, et nous vous notifierons automatiquement lorsque le traitement sera terminé.

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/renovate/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "image_url": "https://exemple.com/image.jpg",
  "theme": "MODERN",
  "room_type": "LIVING_ROOM",
  "webhook": "https://votre-serveur.com/webhooks/iacrea"
}'
```

### Option 2 : Polling

Interrogez régulièrement l'API de récupération jusqu'à ce que le statut soit "SUCCEEDED" ou "FAILED".

```bash theme={null}
curl --request POST \
--url 'https://iacrea.com/api/renovate/get' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "votre-user-id",
  "generation_id": "id-recu-lors-de-la-generation"
}'
```

## Bonnes pratiques d'intégration

* **Gestion des erreurs** : Implémentez un système robuste de gestion des erreurs pour traiter les réponses d'erreur de l'API
* **Cache des images** : Stockez les URL d'images générées pour éviter de refaire des appels inutiles
* **Monitoring** : Suivez régulièrement votre consommation de crédits via l'API de photos restantes
* **Timeout** : Configurez des timeouts appropriés, car le traitement peut prendre plusieurs minutes

## Ressources supplémentaires

<CardGroup>
  <Card title="Documentation API complète" icon="book" href="/api-reference/introduction">
    Consultez notre documentation API détaillée pour tous les endpoints
    disponibles
  </Card>

  <Card title="FAQ" icon="question-circle" href="/faq">
    Trouvez des réponses aux questions fréquemment posées
  </Card>
</CardGroup>

<Note>
  Besoin d'aide pour l'intégration ? Contactez notre équipe de support à
  [contact@iacrea.com](mailto:contact@iacrea.com)
</Note>