Home staging virtuel

API Home Staging Virtuel

Meublez des pièces vides, videz des pièces meublées, rénovez des espaces et éditez l'intérieur avec des prompts ou masques — toutes les opérations sur le contenu d'une pièce au même endroit.

Les endpoints de home staging virtuel couvrent tout ce qui change le contenu d'une pièce : ajouter du mobilier, l'enlever, rénover l'espace, éditions précises par prompt et suppression d'objets par masque. Pour le nettoyage de photos (enhance, sky, blur), voir Amélioration d'images.

Meubler une pièce vide

POST/api/furnish

Ajoute du mobilier réaliste dans une pièce vide. Pedra préserve l'architecture de la pièce (murs, fenêtres, portes, sols) et n'ajoute que mobilier et décoration.

Exemples de staging d'intérieur
Paires avant/après dans des salons, chambres, cuisines et bureaux dans différents styles de mobilier.
Voir les exemples →

Paramètres

apiKeystringobligatoire
Votre clé API.
imageUrlstringobligatoire
URL de la photo de la pièce vide, ou un URI data base64 (data:image/png;base64,...).
roomTypestringobligatoire
Type de pièce à meubler. Les huit valeurs ci-dessous ont des prompts ajustés à la main ; toute autre chaîne (par exemple "Kitchen", "Closet") fonctionne aussi via des prompts générés automatiquement.
Values: Living room Dining + Living room Bedroom Dining room Terrace Entrance Office Bathroom
stylestringobligatoire
Style du mobilier. Passez l'un des styles nommés ci-dessous ou une URL publique vers une image de référence (par exemple une photo Pinterest ou produit) — Pedra reproduira le look de la référence.
Values: Minimalist Modern Scandinavian Industrial Bohemian Mid-century modern Traditional Mediterranean Coastal Rustic Farmhouse Contemporary
creativitystring
Quelle liberté l'IA prend avec le design. Medium est la valeur recommandée par défaut ; High utilise un modèle plus léger et plus rapide. Medium coûte 2 crédits par image, High en coûte 1 — voir Tarification.
Values: Medium High
Default: Medium

Requête d'exemple

curl -X POST https://app.pedra.ai/api/furnish \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/empty-bedroom.jpg",
    "roomType": "Bedroom",
    "style": "Minimalist",
    "creativity": "Medium"
  }'

Réponse d'exemple

JSON
{
  "message": "Success",
  "output": [
    { "url": "https://pedraimages.s3.eu-west-3.amazonaws.com/<generated-id>" }
  ]
}

Temps de réponse : ~30 secondes par image.

Vider une pièce meublée

POST/api/empty_room

Supprime les meubles et objets d'une pièce en laissant l'architecture intacte. Utile quand les photos d'annonce sont prises avec les affaires de l'ancien propriétaire encore en place.

Exemples de désencombrement et de pièces vides
Voyez de vraies annonces transformées d'encombrées à entièrement vides en quelques secondes.
Voir les exemples →

Paramètres

apiKeystringobligatoire
Votre clé API.
imageUrlstringobligatoire
URL de la photo de la pièce meublée, ou un URI data base64.

Requête d'exemple

curl -X POST https://app.pedra.ai/api/empty_room \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/furnished-room.jpg"
  }'

Réponse d'exemple

JSON
{
  "message": "Success",
  "output": [
    { "url": "https://pedraimages.s3.eu-west-3.amazonaws.com/<generated-id>" }
  ]
}

Temps de réponse : ~30 secondes par image.

Rénover une pièce

POST/api/renovation

Montre à quoi pourrait ressembler une pièce après rénovation : nouvelles finitions, cuisines modernisées, salles de bain rafraîchies. En option, conservez les fenêtres et remeublez dans le même appel.

Exemples de rénovation virtuelle
Vrais rendus de rénovation — cuisines datées, salles de bain fatiguées et intérieurs rafraîchis dans plusieurs styles.
Voir les exemples →

Paramètres

apiKeystringobligatoire
Votre clé API.
imageUrlstringobligatoire
URL de la photo de la pièce à rénover.
stylestringobligatoire
Style de la rénovation. Passez l'un des styles nommés ci-dessous ou une URL publique vers une image de référence — Pedra reproduit les finitions, la palette et le look général de la référence.
Values: Minimalist Modern Scandinavian Industrial Bohemian Mid-century modern Traditional Mediterranean Coastal Rustic Farmhouse Contemporary
preserveWindowsboolean
Garde les fenêtres dans leur position d'origine. Recommandé pour des annonces fidèles.
Default: false
furnishboolean
Ajoute du mobilier dans la pièce rénovée dans le même appel. Quand true, roomType est requis.
Default: false
roomTypestring
Utilisé lorsque furnish est true. Par défaut "Auto" (Pedra détecte la pièce à partir de l'image). Même ensemble de valeurs que l'endpoint furnish.
Values: Living room Dining + Living room Bedroom Dining room Terrace Entrance Office Bathroom Auto
Default: Auto
creativitystring
À quel point la rénovation est agressive. Medium est la valeur recommandée par défaut ; High utilise un modèle plus léger et plus rapide. Medium coûte 2 crédits par image, High en coûte 1 — voir Tarification.
Values: Medium High
Default: Medium

Requête d'exemple

curl -X POST https://app.pedra.ai/api/renovation \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/dated-kitchen.jpg",
    "style": "Modern",
    "preserveWindows": true,
    "furnish": true,
    "roomType": "Kitchen",
    "creativity": "Medium"
  }'

Réponse d'exemple

JSON
{
  "message": "Success",
  "output": [
    { "url": "https://pedraimages.s3.eu-west-3.amazonaws.com/<generated-id>" }
  ]
}

Temps de réponse : ~30 secondes par image.

Éditer par prompt

POST/api/edit_via_prompt

Effectuez des modifications ciblées décrites en langage clair : "Add a modern chandelier", "Repaint the walls white", "Remove the rug". Idéal pour les corrections ponctuelles qui ne correspondent pas aux autres endpoints.

Paramètres

apiKeystringobligatoire
Votre clé API.
imageUrlstringobligatoire
URL de la photo à éditer, ou un URI data base64.
promptstringobligatoire
Instruction d'édition en langage clair. Soyez précis — "add a beige sofa against the back wall" fonctionne mieux que "add furniture".

Requête d'exemple

curl -X POST https://app.pedra.ai/api/edit_via_prompt \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/living-room.jpg",
    "prompt": "Add a modern chandelier to the ceiling"
  }'

Réponse d'exemple

JSON
{
  "message": "Success",
  "output": {
    "url": "https://pedraimages.s3.eu-west-3.amazonaws.com/<generated-id>"
  }
}

Temps de réponse : ~15 secondes par image. Coût : 2 crédits par appel. output est un objet unique.

Supprimer un objet

POST/api/remove_object

Supprime des objets spécifiques d'une image à l'aide d'un masque. Le masque est une image distincte où les pixels blancs marquent ce qu'il faut supprimer et les noirs ce qu'il faut conserver. À utiliser quand vous voulez un contrôle chirurgical par rapport à edit_via_prompt.

Exemples de suppression d'objets
Même galerie que /api/empty_room — encombrement, mobilier et objets supprimés de vraies photos d'annonces.
Voir les exemples →

Paramètres

apiKeystringobligatoire
Votre clé API.
imageUrlstringobligatoire
URL de la photo source.
maskUrlstringobligatoire
URL de l'image masque. Les zones blanches sont supprimées ; les zones noires sont conservées.

Requête d'exemple

curl -X POST https://app.pedra.ai/api/remove_object \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/cluttered-room.jpg",
    "maskUrl": "https://example.com/mask.png"
  }'

Réponse d'exemple

JSON
{
  "message": "Success",
  "output": {
    "url": "https://pedraimages.s3.eu-west-3.amazonaws.com/<generated-id>"
  }
}

Temps de réponse : ~15 secondes par image. output est un objet unique.

Suivant

Voir Amélioration d'images pour la netteté, le remplacement de ciel et le floutage — ou Erreurs et limites pour la gestion des échecs.