​
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

​
user_id
string
required

L’identifiant unique de l’utilisateur (UUID)

​
image_url
string
required

URL de l’image de l’espace extérieur à transformer

​
room_type
string
required

Le type d’espace extérieur à aménager. Valeurs acceptées: JARDIN, GAZON, POOL, BALCON, TERRACE.

​
keep_facade
boolean

Si activé, préserve la façade du bâtiment (optionnel)

​
blue_sky
boolean

Si activé, ajoute un ciel bleu à l’image (optionnel)

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

  • JARDIN - Jardin avec fleurs et plantes
  • GAZON - Pelouse verte
  • POOL - Jardin avec piscine
  • BALCON - Balcon ou petite terrasse
  • TERRACE - Terrasse plus grande

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

​
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

​
room_type
string
required

Le type d’espace extérieur à aménager. Valeurs acceptées: JARDIN, GAZON, POOL, BALCON, TERRACE.

​
keep_facade
boolean

Si activé, préserve la façade du bâtiment (optionnel)

​
blue_sky
boolean

Si activé, ajoute un ciel bleu à l’image (optionnel)

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

​
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/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é.

​
status
string

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

​
output_url
string

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"
}