Passer au contenu principal

​
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

​
POST /api/renovate/generate

​
Paramètres de la requête

​
user_id
string
required
L’identifiant unique de l’utilisateur (UUID)
​
image_url
string
required
URL de l’image de l’espace à rénover
​
theme
string
required
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).
​
room_type
string
required
Le type de pièce. Valeurs acceptées: LIVING_ROOM, BEDROOM, BATHROOM, SHOWEROOM, HOME_OFFICE, EMPTY, VERANDA, KITCHEN, DINING_ROOM.
​
photo_360
boolean
Si l’image est une photo panoramique à 360°
​
keep_ceiling
boolean
Préserver le plafond original
​
keep_floor
boolean
Préserver le sol original
​
keep_wall
boolean
Préserver les murs originaux
​
keep_door
boolean
Préserver les portes originales
​
keep_window
boolean
Préserver les fenêtres originales (activé par défaut)
​
furnish
boolean
Meubler la pièce rénovée. Fonctionne uniquement avec: BEDROOM, DINING_ROOM, LIVING_ROOM, HOME_OFFICE.
​
webhook
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

​
generation_id
string
L’identifiant unique de la génération (UUID)
​
remaining_photos
number
Le nombre de crédits photos restants pour l’utilisateur
​
project_id
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

​
POST /api/renovate/generate-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

​
user_id
string
required
L’identifiant unique de l’utilisateur (UUID)
​
generation_id
string
required
L’identifiant de la génération précédente dont vous souhaitez créer une variation
​
theme
string
required
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).
​
room_type
string
required
Le type de pièce. Valeurs acceptées: LIVING_ROOM, BEDROOM, BATHROOM, SHOWEROOM, HOME_OFFICE, EMPTY, VERANDA, KITCHEN, DINING_ROOM.
​
photo_360
boolean
Si l’image est une photo panoramique à 360°
​
keep_ceiling
boolean
Préserver le plafond original
​
keep_floor
boolean
Préserver le sol original
​
keep_wall
boolean
Préserver les murs originaux
​
keep_door
boolean
Préserver les portes originales
​
keep_window
boolean
Préserver les fenêtres originales (activé par défaut)
​
furnish
boolean
Meubler la pièce rénovée. Fonctionne uniquement avec: BEDROOM, DINING_ROOM, LIVING_ROOM, HOME_OFFICE.
​
webhook
string
URL du webhook pour les notifications (optionnel)

​
Réponse

​
generation_id
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

​
POST /api/renovate/get

​
Paramètres de la requête

​
user_id
string
required
L’identifiant unique de l’utilisateur (UUID)
​
generation_id
string
required
L’identifiant unique de la génération (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é.
​
status
string
État de la génération: “starting”, “in_progress”, “succeeded”, “failed”
​
output_url
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"
}
⌘I