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/v2/generate
Paramètres de la requête
L’identifiant unique de l’utilisateur (UUID)
URL de l’image d’espace à meubler
Le thème d’ameublement souhaité. Valeurs acceptées: MODERN, SCANDINAVIAN, COASTAL, FARMHOUSE, LUXURY, AMERICAN.
Le type de pièce à meubler. Valeurs acceptées: LIVING_ROOM, BEDROOM, DINING, HOME_OFFICE, OFFICE, KIDS, OUTDOOR.
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
L’identifiant unique de la génération (UUID)
Le nombre de crédits photos restants pour l’utilisateur
L’identifiant unique du projet (UUID)
Exemple de requête
curl -X POST https://api.iacrea.ai/api/furnish/v2/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/v2/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
L’identifiant unique de l’utilisateur (UUID)
L’identifiant de la génération précédente dont vous souhaitez créer une variation
Le thème d’ameublement souhaité. Valeurs acceptées: MODERN, SCANDINAVIAN, COASTAL, FARMHOUSE, LUXURY, AMERICAN.
Le type de pièce à meubler. Valeurs acceptées: LIVING_ROOM, BEDROOM, DINING, HOME_OFFICE, OFFICE, KIDS, OUTDOOR.
URL du webhook pour les notifications (optionnel)
Réponse
L’identifiant unique de la nouvelle génération (UUID)
Exemple de requête
curl -X POST https://api.iacrea.ai/api/furnish/v2/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
Paramètres de la requête
L’identifiant unique de l’utilisateur (UUID)
L’identifiant unique de la génération (UUID) retourné par l’endpoint /api/furnish/v2/generate
ou /api/furnish/v2/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é.
État de la génération: “starting”, “in_progress”, “succeeded”, “failed”
URLs des images meublées (uniquement présent si status=“succeeded”)
Numéro de la variation (optionnel)
Exemple de requête
curl -X POST https://api.iacrea.ai/api/furnish/v2/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
}