Virtuelles Home Staging

Virtuelles Home Staging API

Möblieren Sie leere Räume, leeren Sie möblierte Räume, renovieren Sie Räume und bearbeiten Sie Interieurs mit Prompts oder Masken — alle Raum-Inhaltsoperationen an einem Ort.

Die Virtual-Staging-Endpunkte decken alles ab, was den Inhalt eines Raums verändert: Möbel hinzufügen, entfernen, den Raum renovieren, präzise Bearbeitungen per Prompt und maskenbasierte Objektentfernung. Für die Foto-Bereinigung (enhance, sky, blur) siehe Bildverbesserung.

Einen leeren Raum möblieren

POST/api/furnish

Fügt realistische Möbel in einen leeren Raum ein. Pedra erhält die Raumarchitektur (Wände, Fenster, Türen, Böden) und fügt nur Möbel und Dekoration hinzu.

Beispiele für Interior Staging
Vorher/Nachher-Paare in Wohnzimmern, Schlafzimmern, Küchen und Büros in verschiedenen Möbelstilen.
Beispiele ansehen →

Parameter

apiKeystringerforderlich
Ihr API-Schlüssel.
imageUrlstringerforderlich
URL des Fotos des leeren Raums oder ein base64-data-URI (data:image/png;base64,...).
roomTypestringerforderlich
Raumtyp zum Möblieren. Die acht unten aufgeführten Werte haben handgestaltete Prompts; jeder andere String (z. B. "Kitchen", "Closet") funktioniert ebenfalls über automatisch generierte Prompts.
Values: Living room Dining + Living room Bedroom Dining room Terrace Entrance Office Bathroom
stylestringerforderlich
Möbelstil. Übergeben Sie einen der unten genannten Stile oder eine öffentliche URL zu einem Referenzbild (z. B. ein Pinterest-Foto oder Produktbild) — Pedra wird den Look der Referenz übernehmen.
Values: Minimalist Modern Scandinavian Industrial Bohemian Mid-century modern Traditional Mediterranean Coastal Rustic Farmhouse Contemporary
creativitystring
Wie viel Freiheit die KI mit dem Design nimmt. Medium ist der empfohlene Standard; High läuft auf einem leichteren, schnelleren Modell. Medium kostet 2 Credits pro Bild, High 1 — siehe Preise.
Values: Medium High
Default: Medium

Beispielanfrage

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"
  }'

Beispielantwort

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

Antwortzeit: ~30 Sekunden pro Bild.

Einen möblierten Raum leeren

POST/api/empty_room

Entfernt Möbel und Objekte aus einem Raum und lässt die Architektur unangetastet. Nützlich, wenn Anzeigenfotos noch mit den Sachen des Vorbesitzers aufgenommen wurden.

Beispiele für Aufräumen und leere Räume
Sehen Sie echte Anzeigen, die in Sekunden von vollgestopft zu komplett leer verwandelt wurden.
Beispiele ansehen →

Parameter

apiKeystringerforderlich
Ihr API-Schlüssel.
imageUrlstringerforderlich
URL des Fotos des möblierten Raums oder ein base64-data-URI.

Beispielanfrage

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"
  }'

Beispielantwort

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

Antwortzeit: ~30 Sekunden pro Bild.

Einen Raum renovieren

POST/api/renovation

Zeigt, wie ein Raum nach einer Renovierung aussehen könnte: neue Oberflächen, modernisierte Küchen, erfrischte Bäder. Optional Fenster beibehalten und im gleichen Aufruf neu möblieren.

Beispiele für virtuelle Renovierung
Echte Renovierungs-Renderings — veraltete Küchen, müde Bäder und erfrischte Innenräume in verschiedenen Stilen.
Beispiele ansehen →

Parameter

apiKeystringerforderlich
Ihr API-Schlüssel.
imageUrlstringerforderlich
URL des Fotos des zu renovierenden Raums.
stylestringerforderlich
Renovierungsstil. Übergeben Sie einen der unten genannten Stile oder eine öffentliche URL zu einem Referenzbild — Pedra übernimmt Oberflächen, Palette und Gesamtlook der Referenz.
Values: Minimalist Modern Scandinavian Industrial Bohemian Mid-century modern Traditional Mediterranean Coastal Rustic Farmhouse Contemporary
preserveWindowsboolean
Behält Fenster in ihrer ursprünglichen Position. Empfohlen für genaue Anzeigen.
Default: false
furnishboolean
Fügt Möbel zum renovierten Raum im gleichen Aufruf hinzu. Wenn true, ist roomType erforderlich.
Default: false
roomTypestring
Wird verwendet, wenn furnish true ist. Standardmäßig "Auto" (Pedra erkennt den Raum aus dem Bild). Gleiche Wertemenge wie der furnish-Endpunkt.
Values: Living room Dining + Living room Bedroom Dining room Terrace Entrance Office Bathroom Auto
Default: Auto
creativitystring
Wie aggressiv die Renovierung ist. Medium ist der empfohlene Standard; High läuft auf einem leichteren, schnelleren Modell. Medium kostet 2 Credits pro Bild, High 1 — siehe Preise.
Values: Medium High
Default: Medium

Beispielanfrage

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"
  }'

Beispielantwort

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

Antwortzeit: ~30 Sekunden pro Bild.

Per Prompt bearbeiten

POST/api/edit_via_prompt

Machen Sie gezielte Änderungen in einfacher Sprache: "Add a modern chandelier", "Repaint the walls white", "Remove the rug". Am besten für einmalige Korrekturen, die nicht zu den anderen Endpunkten passen.

Parameter

apiKeystringerforderlich
Ihr API-Schlüssel.
imageUrlstringerforderlich
URL des zu bearbeitenden Fotos oder ein base64-data-URI.
promptstringerforderlich
Bearbeitungsanweisung in einfacher Sprache. Seien Sie spezifisch — "add a beige sofa against the back wall" funktioniert besser als "add furniture".

Beispielanfrage

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"
  }'

Beispielantwort

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

Antwortzeit: ~15 Sekunden pro Bild. Kosten: 2 Credits pro Aufruf. output ist ein einzelnes Objekt.

Objekt entfernen

POST/api/remove_object

Entfernt bestimmte Objekte aus einem Bild mithilfe einer Maske. Die Maske ist ein separates Bild, in dem weiße Pixel markieren, was entfernt werden soll, und schwarze Pixel, was beibehalten wird. Verwenden Sie es, wenn Sie chirurgische Kontrolle vs. edit_via_prompt benötigen.

Beispiele für Objektentfernung
Gleiche Galerie wie /api/empty_room — Unordnung, Möbel und Objekte aus echten Anzeigenfotos entfernt.
Beispiele ansehen →

Parameter

apiKeystringerforderlich
Ihr API-Schlüssel.
imageUrlstringerforderlich
URL des Quellfotos.
maskUrlstringerforderlich
URL des Maskenbildes. Weiße Bereiche werden entfernt; schwarze Bereiche bleiben erhalten.

Beispielanfrage

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"
  }'

Beispielantwort

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

Antwortzeit: ~15 Sekunden pro Bild. output ist ein einzelnes Objekt.

Weiter

Siehe Bildverbesserung für Schärfung, Himmel-Ersatz und Verwischung — oder Fehler und Limits für Fehlerbehandlung.