Passer au contenu principal

​
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

​
POST /api/exterior/v3/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
​
options
string
Instructions personnalisées pour l’aménagement extérieur (optionnel). Exemples: “Ajouter une piscine”, “Ajouter un barbecue”, “Ajouter du mobilier extérieur”
​
webhook
string
URL du webhook pour les notifications (optionnel)
​
project_id
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

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

​
POST /api/exterior/v3/generate-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

​
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
​
options
string
Nouvelles instructions personnalisées pour la variation (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/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

​
POST /api/exterior/v3/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/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é.
​
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/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"
}
⌘I