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

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

string

requis

L’identifiant unique de l’utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur

string

requis

URL de l’image servant de base à la création (format: jpg, png)

string

requis

URL du masque indiquant la zone où l’extérieur doit être généré

string

requis

Type d’extérieur à générer. Valeurs possibles: “TERRACE”, “POOL”, “PETANQUE”

number

requis

Largeur de l’image en pixels

number

requis

Hauteur de l’image en pixels

string

L’URL que nous appelons une fois que la génération est terminée

Réponse

string

L’identifiant unique de la génération (UUID) à utiliser avec l’API de récupération

number

Le nombre de photos restant suite à cette génération

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

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

string

requis

L’identifiant unique de l’utilisateur (UUID)

string

requis

L’identifiant unique de la génération précédente

string

requis

URL de l’image originale utilisée pour la génération précédente

string

URL optionnelle d’un nouveau masque. Si non fourni, le masque de la génération précédente sera utilisé

string

requis

Type d’extérieur pour cette variation. Valeurs possibles: “TERRACE”, “POOL”, “PETANQUE”

string

L’URL que nous appelons une fois que la génération est terminée

Réponse

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

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

string

requis

L’identifiant unique de l’utilisateur (UUID)

string

requis

L’identifiant unique de la génération à récupérer

Réponse

string

Le statut de la génération: “STARTING”, “PROCESSING”, “SUCCEEDED”, “FAILED”

array

Un tableau d’URL contenant les URLs des images générées (présent seulement si status=“SUCCEEDED”)

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.

Documentation API

Endpoints

API Création d'Extérieur

API Création d’Extérieur

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

Paramètres de la requête

Réponse

Exemple de requête

Exemple de réponse

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

Paramètres de la requête

Réponse

Exemple de requête

Exemple de réponse

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

Paramètres de la requête

Réponse

Exemple de requête

Exemple de réponse

​API Création d’Extérieur

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

​Paramètres de la requête

​Réponse

​Exemple de requête

​Exemple de réponse

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

​Paramètres de la requête

​Réponse

​Exemple de requête

​Exemple de réponse

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

​Paramètres de la requête

​Réponse

​Exemple de requête

​Exemple de réponse

API Création d’Extérieur

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

Paramètres de la requête

Réponse

Exemple de requête

Exemple de réponse

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

Paramètres de la requête

Réponse

Exemple de requête

Exemple de réponse

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

Paramètres de la requête

Réponse

Exemple de requête

Exemple de réponse