Passer au contenu principal

​
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/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 d’espace à meubler
​
theme
string
required
Le thème d’ameublement souhaité. Valeurs acceptées: MODERN, SCANDINAVIAN, COASTAL, FARMHOUSE, LUXURY, AMERICAN.
​
room_type
string
required
Le type de pièce à meubler. Valeurs acceptées: LIVING_ROOM, BEDROOM, DINING, HOME_OFFICE, 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
  • OFFICE - Bureau d’entreprise
  • KIDS - Chambre d’enfant
  • OUTDOOR - Espace extérieur

​
Valeurs disponibles pour theme

Les valeurs suivantes sont acceptées pour le paramètre theme :
  • MODERN - Style moderne
  • SCANDINAVIAN - Style scandinave
  • 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/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/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/v3/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: MODERN, SCANDINAVIAN, COASTAL, FARMHOUSE, LUXURY, AMERICAN.
​
room_type
string
required
Le type de pièce à meubler. Valeurs acceptées: LIVING_ROOM, BEDROOM, DINING, HOME_OFFICE, 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/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",
    "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/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/furnish/v3/generate ou /api/furnish/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”
​
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/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",
  "urls": [
    "https://storage.iacrea.ai/output/123e4567-e89b-12d3-a456-426614174001.jpg"
  ],
  "variationNumber": 1
}
⌘I