API Aménagement Extérieur v3

Le service d’aménagement extérieur v3 vous permet de transformer virtuellement l’aspect extérieur des bâtiments, jardins, terrasses et autres espaces extérieurs avec des options personnalisées avancées.

Générer un aménagement extérieur

Paramètres de la requête

string

requis

L’identifiant unique de l’utilisateur (UUID)

string

requis

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

string

Instructions personnalisées pour l’aménagement extérieur (optionnel). Exemples: “Ajouter une piscine”, “Ajouter un barbecue”, “Ajouter du mobilier extérieur”

string

URL du webhook pour les notifications (optionnel)

string

L’identifiant du projet (optionnel, sera généré automatiquement si non fourni)

Options personnalisées

La v3 introduit un système d’options personnalisées qui vous permet de décrire précisément ce que vous souhaitez ajouter à votre extérieur. Voici quelques exemples :

"Ajouter une piscine" - Ajoute une piscine moderne
"Ajouter un barbecue" - Installe un barbecue extérieur
"Ajouter du mobilier extérieur" - Ajoute des meubles de jardin
"Ajouter des plantes" - Enrichit avec des végétaux
"Ajouter une terrasse" - Crée une terrasse en bois
"Ajouter un jardin" - Aménage un jardin paysager

Vous pouvez combiner plusieurs instructions : "Ajouter une piscine avec terrasse en bois, installer un barbecue moderne"

Réponse

string

L’identifiant unique de la génération (UUID)

number

Le nombre de crédits photos restants pour l’utilisateur

string

L’identifiant unique du projet (UUID)

Exemple de requête

curl -X POST https://api.iacrea.ai/api/exterior/v3/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",
    "options": "Ajouter une piscine avec terrasse en bois, installer un barbecue moderne"
  }'

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

Cette API vous permet de générer des variations à partir d’un résultat précédent avec de nouvelles options personnalisées.

Paramètres de la requête

string

requis

L’identifiant unique de l’utilisateur (UUID)

string

requis

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

string

Nouvelles instructions personnalisées pour la variation (optionnel)

string

URL du webhook pour les notifications (optionnel)

Réponse

string

L’identifiant unique de la nouvelle génération (UUID)

Exemple de requête

curl -X POST https://api.iacrea.ai/api/exterior/v3/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",
    "options": "Ajouter des plantes tropicales et un éclairage extérieur"
  }'

Exemple de réponse

{
  "generation_id": "123e4567-e89b-12d3-a456-426614174003"
}

Récupérer un aménagement extérieur

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 (UUID) retourné par l’endpoint /api/exterior/v3/generate ou /api/exterior/v3/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é.

string

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

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

Documentation API

Endpoints

API Aménagement Extérieur v3

API Aménagement Extérieur v3

Générer un aménagement extérieur

Paramètres de la requête

Options personnalisées

Réponse

Exemple de requête

Exemple de réponse

Générer une variation

Paramètres de la requête

Réponse

Exemple de requête

Exemple de réponse

Récupérer un aménagement extérieur

Paramètres de la requête

Réponse

Exemple de requête

Exemple de réponse

​API Aménagement Extérieur v3

​Générer un aménagement extérieur

​Paramètres de la requête

​Options personnalisées

​Réponse

​Exemple de requête

​Exemple de réponse

​Générer une variation

​Paramètres de la requête

​Réponse

​Exemple de requête

​Exemple de réponse

​Récupérer un aménagement extérieur

​Paramètres de la requête

​Réponse

​Exemple de requête

​Exemple de réponse

API Aménagement Extérieur v3

Générer un aménagement extérieur

Paramètres de la requête

Options personnalisées

Réponse

Exemple de requête

Exemple de réponse

Générer une variation

Paramètres de la requête

Réponse

Exemple de requête

Exemple de réponse

Récupérer un aménagement extérieur

Paramètres de la requête

Réponse

Exemple de requête

Exemple de réponse