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
L’identifiant unique de l’utilisateur (UUID)
URL de l’image de l’espace à rénover
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).
Le type de pièce. Valeurs acceptées: LIVING_ROOM, BEDROOM, BATHROOM, SHOWEROOM, HOME_OFFICE, EMPTY, VERANDA, KITCHEN, DINING_ROOM.
Si l’image est une photo panoramique à 360°
Préserver le plafond original
Préserver le sol original
Préserver les murs originaux
Préserver les portes originales
Préserver les fenêtres originales (activé par défaut)
Meubler la pièce rénovée. Fonctionne uniquement avec: BEDROOM, DINING_ROOM, LIVING_ROOM, HOME_OFFICE.
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
L’identifiant unique de la génération (UUID)
Le nombre de crédits photos restants pour l’utilisateur
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
L’identifiant unique de l’utilisateur (UUID)
L’identifiant de la génération précédente dont vous souhaitez créer une variation
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).
Le type de pièce. Valeurs acceptées: LIVING_ROOM, BEDROOM, BATHROOM, SHOWEROOM, HOME_OFFICE, EMPTY, VERANDA, KITCHEN, DINING_ROOM.
Si l’image est une photo panoramique à 360°
Préserver le plafond original
Préserver le sol original
Préserver les murs originaux
Préserver les portes originales
Préserver les fenêtres originales (activé par défaut)
Meubler la pièce rénovée. Fonctionne uniquement avec: BEDROOM, DINING_ROOM, LIVING_ROOM, HOME_OFFICE.
URL du webhook pour les notifications (optionnel)
Réponse
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
L’identifiant unique de l’utilisateur (UUID)
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é.
État de la génération: “starting”, “in_progress”, “succeeded”, “failed”
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"
}