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

Paramètres de la requête

string

requis

L’identifiant unique de l’utilisateur (UUID)

string

requis

URL de l’image de l’espace à rénover

string

requis

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

string

requis

Le type de pièce. Valeurs acceptées: LIVING_ROOM, BEDROOM, BATHROOM, SHOWEROOM, HOME_OFFICE, EMPTY, VERANDA, KITCHEN, DINING_ROOM.

boolean

Si l’image est une photo panoramique à 360°

boolean

Préserver le plafond original

boolean

Préserver le sol original

boolean

Préserver les murs originaux

boolean

Préserver les portes originales

boolean

Préserver les fenêtres originales (activé par défaut)

boolean

Meubler la pièce rénovée. Fonctionne uniquement avec: BEDROOM, DINING_ROOM, LIVING_ROOM, HOME_OFFICE.

string

URL du webhook pour les notifications (optionnel)

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

string

L’identifiant unique de la génération (UUID)

number

Le nombre de crédits photos restants pour l’utilisateur

string

L’identifiant unique du projet (UUID)

Exemple de requête

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

{
  "generation_id": "123e4567-e89b-12d3-a456-426614174001",
  "remaining_photos": 6,
  "project_id": "123e4567-e89b-12d3-a456-426614174002"
}

Générer une variation

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

Paramètres de la requête

string

requis

L’identifiant unique de l’utilisateur (UUID)

string

requis

L’identifiant de la génération précédente dont vous souhaitez créer une variation

string

requis

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

string

requis

Le type de pièce. Valeurs acceptées: LIVING_ROOM, BEDROOM, BATHROOM, SHOWEROOM, HOME_OFFICE, EMPTY, VERANDA, KITCHEN, DINING_ROOM.

boolean

Si l’image est une photo panoramique à 360°

boolean

Préserver le plafond original

boolean

Préserver le sol original

boolean

Préserver les murs originaux

boolean

Préserver les portes originales

boolean

Préserver les fenêtres originales (activé par défaut)

boolean

Meubler la pièce rénovée. Fonctionne uniquement avec: BEDROOM, DINING_ROOM, LIVING_ROOM, HOME_OFFICE.

string

URL du webhook pour les notifications (optionnel)

Réponse

string

L’identifiant unique de la nouvelle génération (UUID)

Exemple de requête

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

{
  "generation_id": "123e4567-e89b-12d3-a456-426614174003"
}

Récupérer une rénovation

Paramètres de la requête

string

requis

L’identifiant unique de l’utilisateur (UUID)

string

requis

L’identifiant unique de la génération (UUID) retourné par l’endpoint /api/renovate/generate ou /api/renovate/generate-variation

Réponse

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

string

État de la génération: “starting”, “in_progress”, “succeeded”, “failed”

string

URL de l’image rénovée (uniquement présent si status=“succeeded”)

Exemple de requête

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

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

Documentation API

Endpoints

API Rénovation

API Rénovation

Générer une rénovation

Paramètres de la requête

Valeurs disponibles pour room_type

Valeurs disponibles pour theme

Pièces compatibles avec l’option furnish

Réponse

Exemple de requête

Exemple de réponse

Générer une variation

Paramètres de la requête

Réponse

Exemple de requête

Exemple de réponse

Récupérer une rénovation

Paramètres de la requête

Réponse

Exemple de requête

Exemple de réponse

​API Rénovation

​Générer une rénovation

​Paramètres de la requête

​Valeurs disponibles pour room_type

​Valeurs disponibles pour theme

​Pièces compatibles avec l’option furnish

​Réponse

​Exemple de requête

​Exemple de réponse

​Générer une variation

​Paramètres de la requête

​Réponse

​Exemple de requête

​Exemple de réponse

​Récupérer une rénovation

​Paramètres de la requête

​Réponse

​Exemple de requête

​Exemple de réponse

API Rénovation

Générer une rénovation

Paramètres de la requête

Valeurs disponibles pour room_type

Valeurs disponibles pour theme

Pièces compatibles avec l’option furnish

Réponse

Exemple de requête

Exemple de réponse

Générer une variation

Paramètres de la requête

Réponse

Exemple de requête

Exemple de réponse

Récupérer une rénovation

Paramètres de la requête

Réponse

Exemple de requête

Exemple de réponse