​
API Ameublement

Le service d’ameublement vous permet de meubler virtuellement des espaces vides ou de remplacer le mobilier existant dans vos images.

​
Générer un ameublement

​
POST /api/furnish/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 d’espace à meubler

​
theme
string
required

Le thème d’ameublement souhaité. Valeurs acceptées: STANDARD, MODERN, SCANDINAVIAN, INDUSTRIAL, COASTAL, FARMHOUSE, LUXURY, AMERICAN.

​
room_type
string
required

Le type de pièce à meubler. Valeurs acceptées: LIVING_ROOM, BEDROOM, DINING, HOME_OFFICE, KIDS, OUTDOOR.

​
webhook
string

URL du webhook pour les notifications (optionnel)

​
Valeurs disponibles pour room_type

Les valeurs suivantes sont acceptées pour le paramètre room_type :

  • LIVING_ROOM - Salon
  • BEDROOM - Chambre
  • DINING - Salle à manger
  • HOME_OFFICE - Bureau
  • KIDS - Chambre d’enfant
  • OUTDOOR - Espace extérieur

​
Valeurs disponibles pour theme

Les valeurs suivantes sont acceptées pour le paramètre theme :

  • STANDARD - Style standard
  • MODERN - Style moderne
  • SCANDINAVIAN - Style scandinave
  • INDUSTRIAL - Style industriel
  • COASTAL - Style bord de mer
  • FARMHOUSE - Style champêtre
  • LUXURY - Style luxueux
  • AMERICAN - Style américain

​
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/furnish/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/espace-vide.jpg",
    "theme": "MODERN",
    "room_type": "LIVING_ROOM"
  }'

​
Exemple de réponse

{
  "generation_id": "123e4567-e89b-12d3-a456-426614174001",
  "remaining_photos": 7,
  "project_id": "123e4567-e89b-12d3-a456-426614174002"
}

​
Générer une variation

​
POST /api/furnish/generate-variation

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

​
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

​
theme
string
required

Le thème d’ameublement souhaité. Valeurs acceptées: STANDARD, MODERN, SCANDINAVIAN, INDUSTRIAL, COASTAL, FARMHOUSE, LUXURY, AMERICAN.

​
room_type
string
required

Le type de pièce à meubler. Valeurs acceptées: LIVING_ROOM, BEDROOM, DINING, HOME_OFFICE, KIDS, OUTDOOR.

​
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/furnish/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",
    "theme": "SCANDINAVIAN",
    "room_type": "LIVING_ROOM"
  }'

​
Exemple de réponse

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

​
Récupérer un ameublement

​
POST /api/furnish/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/furnish/generate ou /api/furnish/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”

​
urls
array

URLs des images meublées (uniquement présent si status=“succeeded”)

​
variationNumber
number

Numéro de la variation (optionnel)

​
Exemple de requête

curl -X POST https://api.iacrea.ai/api/furnish/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",
  "urls": ["https://storage.iacrea.ai/output/123e4567-e89b-12d3-a456-426614174001.jpg"],
  "variationNumber": 1
}