API Aménagement Extérieur
Le service d’aménagement extérieur vous permet de transformer virtuellement l’aspect extérieur des bâtiments, jardins, terrasses et autres espaces extérieurs.
Générer un aménagement extérieur
POST /api/exterior/v2/generate
Paramètres de la requête
L’identifiant unique de l’utilisateur (UUID)
URL de l’image de l’espace extérieur à transformer
Le type d’espace extérieur à aménager. Valeurs acceptées: JARDIN, GAZON, POOL, BALCON, TERRACE.
Si activé, préserve la façade du bâtiment (optionnel)
Si activé, ajoute un ciel bleu à l’image (optionnel)
URL du webhook pour les notifications (optionnel)
Valeurs disponibles pour room_type
Les valeurs suivantes sont acceptées pour le paramètre room_type
:
JARDIN
- Jardin avec fleurs et plantes
GAZON
- Pelouse verte
POOL
- Jardin avec piscine
BALCON
- Balcon ou petite terrasse
TERRACE
- Terrasse plus grande
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/exterior/v2/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",
"room_type": "JARDIN",
"keep_facade": true,
"blue_sky": true
}'
Exemple de réponse
{
"generation_id": "123e4567-e89b-12d3-a456-426614174001",
"remaining_photos": 9,
"project_id": "123e4567-e89b-12d3-a456-426614174002"
}
Générer une variation
POST /api/exterior/v2/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 type d’espace extérieur à aménager. Valeurs acceptées: JARDIN, GAZON, POOL, BALCON, TERRACE.
Si activé, préserve la façade du bâtiment (optionnel)
Si activé, ajoute un ciel bleu à l’image (optionnel)
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/exterior/v2/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",
"room_type": "POOL",
"keep_facade": false,
"blue_sky": true
}'
Exemple de réponse
{
"generation_id": "123e4567-e89b-12d3-a456-426614174003"
}
Récupérer un aménagement extérieur
POST /api/exterior/v2/get
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/exterior/v2/generate
ou /api/exterior/v2/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 transformée (uniquement présent si status=“succeeded”)
Exemple de requête
curl -X POST https://api.iacrea.ai/api/exterior/v2/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"
}