​
API Plan 3D

Le service de Plan 3D vous permet de générer une visualisation réaliste d’un espace à partir d’un plan 3D. Idéal pour visualiser des projets immobiliers avant leur construction.

​
Générer une rénovation à partir d’un plan

​
POST /api/plan/generate

Ce endpoint permet de générer une représentation visuelle réaliste à partir d’un plan. Comme une génération peut prendre plusieurs minutes pour s’exécuter, le résultat n’est pas immédiatement disponible.

Pour obtenir le résultat final, vous devez soit fournir une URL de webhook, soit interroger régulièrement l’API de récupération.

​
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 du plan à transformer (format: jpg, png)

​
theme
string
required

Thème de votre nouvelle rénovation. Les valeurs dépendent du type de pièce sélectionné. Exemples: “MODERN”, “SCANDINAVIAN”, “LUXURIOUS”, etc.

​
room_type
string
required

Votre type de pièce. Valeurs possibles: LIVING_ROOM, BEDROOM, EMPTY, KITCHEN, DINING_ROOM, DINING_LIVING_ROOM, HOME_OFFICE, SHOWEROOM, BATHROOM, VERANDA, WC

​
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/plan/generate' \
--header x-api-key:API_KEY \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "image_url": "https://my-image-url.jpg",
  "theme": "MODERN",
  "room_type": "LIVING_ROOM"
}'

​
Exemple de réponse

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

​
Générer une variation à partir d’un plan

​
POST /api/plan/generate-variation

Ce endpoint permet de générer une variation à partir d’un résultat précédent de génération de plan. Comme une génération peut prendre plusieurs minutes, le résultat n’est pas immédiatement disponible.

​
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

​
generation_id
string
required

L’identifiant unique de la génération précédente dont vous souhaitez créer une variation

​
theme
string
required

Thème de votre nouvelle rénovation

​
room_type
string
required

Votre type de pièce

​
Réponse

​
generation_id
string

L’identifiant unique de la nouvelle 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

​
Exemple de requête

curl --request POST \
--url 'https://iacrea.com/api/plan/generate-variation' \
--header x-api-key:API_KEY \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "generation_id": "uuid",
  "theme": "MODERN",
  "room_type": "LIVING_ROOM"
}'

​
Exemple de réponse

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

​
Récupérer une rénovation générée à partir d’un plan

​
POST /api/plan/get

Ce endpoint vous permet d’obtenir le résultat d’une génération précédemment effectuée. Il permet de savoir où en est votre génération grâce au statut et de récupérer l’url de vos images générées.

Note importante: En cas de statut “FAILED”, vos photos sont automatiquement remboursées.

​
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

​
generation_id
string
required

L’identifiant unique de la génération (UUID) retourné par l’API de génération

​
Réponse

​
status
string

Le status 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/plan/get' \
--header x-api-key: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": 2
}