API Création d’Extérieur

Le service de Création d’Extérieur vous permet de générer des visualisations réalistes d’espaces extérieurs à partir d’une zone désignée dans une image.

Générer une création d’extérieur

POST /api/create_exterior/generate
Cet endpoint lance une nouvelle génération pour créer un espace extérieur dans une zone spécifiée par un masque. Cette opération crée aussi un nouveau projet.

Paramètres de la requête

user_id
string
required
L’identifiant unique de l’utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
image_url
string
required
URL de l’image servant de base à la création (format: jpg, png)
mask_url
string
required
URL du masque indiquant la zone où l’extérieur doit être généré
room_type
string
required
Type d’extérieur à générer. Valeurs possibles: “TERRACE”, “POOL”, “PETANQUE”
width
number
required
Largeur de l’image en pixels
height
number
required
Hauteur de l’image en pixels
webhook
string
L’URL que nous appelons une fois que la génération est terminée

Réponse

generation_id
string
L’identifiant unique de la génération (UUID) à utiliser avec l’API de récupération
remaining_photos
number
Le nombre de photos restant suite à cette génération
project_id
string
L’identifiant unique du projet (UUID)

Exemple de requête

curl --request POST \
--url 'https://iacrea.com/api/create_exterior/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "image_url": "https://exemple.com/image.jpg",
  "mask_url": "https://exemple.com/masque.png",
  "room_type": "TERRACE",
  "width": 1024,
  "height": 768
}'

Exemple de réponse

{
  "generation_id": "uuid",
  "remaining_photos": 100,
  "project_id": "uuid"
}

Générer une variation d’extérieur

POST /api/create_exterior/generate-variation
Cet endpoint permet de générer une variation d’une création d’extérieur précédemment réalisée.

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 précédente
original_url
string
required
URL de l’image originale utilisée pour la génération précédente
mask_url
string
URL optionnelle d’un nouveau masque. Si non fourni, le masque de la génération précédente sera utilisé
room_type
string
required
Type d’extérieur pour cette variation. Valeurs possibles: “TERRACE”, “POOL”, “PETANQUE”
webhook
string
L’URL que nous appelons une fois que la génération est terminée

Réponse

generation_id
string
L’identifiant unique de la nouvelle génération

Exemple de requête

curl --request POST \
--url 'https://iacrea.com/api/create_exterior/generate-variation' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "generation_id": "uuid",
  "original_url": "https://exemple.com/image.jpg",
  "mask_url": "https://exemple.com/nouveau-masque.png",
  "room_type": "POOL"
}'

Exemple de réponse

{
  "generation_id": "uuid"
}

Récupérer une création d’extérieur

POST /api/create_exterior/get
Cet endpoint vous permet d’obtenir le résultat d’une génération précédemment effectuée.

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 à récupérer

Réponse

status
string
Le statut de la génération: “STARTING”, “PROCESSING”, “SUCCEEDED”, “FAILED”
urls
array
Un tableau d’URL contenant les URLs des images générées (présent seulement si status=“SUCCEEDED”)
variationNumber
number
Le nombre de variations déjà effectuées sur ce projet

Exemple de requête

curl --request POST \
--url 'https://iacrea.com/api/create_exterior/get' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "generation_id": "uuid"
}'

Exemple de réponse

{
  "status": "SUCCEEDED",
  "urls": ["https://url-de-image-generée"],
  "variationNumber": 0
}
Note importante: En cas de statut “FAILED”, vos photos sont automatiquement remboursées.