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
Art des zu möblierenden Raums. Die acht unten aufgeführten Werte sind die vordefinierten Raumtypen. Sie können auch jeden anderen Raum als benutzerdefinierten String übergeben (z. B. "Kid's room", "Garden", "Home gym").
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
Veraltet und seit September 2026 ignoriert. Die Einrichtung hat jetzt nur noch eine Stufe: Sie fügt Möbel und Dekoration hinzu und lässt Wände, Türen, Fenster und den Kamerawinkel exakt unverändert, für 1 Credit pro Bild (2, wenn style die URL eines Referenzbilds ist). Anfragen, die diesen Parameter noch senden, funktionieren weiterhin.
preserveAspectRatioboolean
Standardmäßig wird das Ergebnis in der Größe zurückgegeben, die das KI-Modell erzeugt – diese kann vom Seitenverhältnis und der Auflösung Ihres Fotos abweichen. Auf true setzen, um das Ergebnis in exakt der Breite und Höhe des Eingabebildes zu erhalten: Es wird mittig auf das ursprüngliche Seitenverhältnis zugeschnitten (nie gestreckt) und auf die ursprüngliche Auflösung skaliert.
Default: false
propertyIdstring
Optionale Id der Immobilie (von list_properties oder create_property), zu der dieses Foto gehört. Wenn angegeben, wird das Ergebnis in der Galerie dieser Immobilie gespeichert — sichtbar und in der App bearbeitbar — statt nur als URL zurückgegeben zu werden. Die Antwort enthält dann zusätzlich <code>source</code> (<code>imageId</code> und <code>name</code>) des Originalfotos, sofern es bereits in dieser Immobilie liegt oder Sie zusätzlich <code>name</code> senden.
namestring
Optionaler Name für das Originalfoto (z. B. der Dateiname), bis zu 200 Zeichen. Erfordert <code>propertyId</code>. Liegt das Foto noch nicht in dieser Immobilie, wird es im selben Aufruf unter diesem Namen dort gespeichert, ein vorheriges <code>add_images_to_property</code> ist also nicht nötig, und der Name wird als <code>source.name</code> zurückgegeben. Ein Foto, das bereits in der Immobilie liegt, behält seinen Namen. Erscheint nie auf dem Bild.

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

Beispielantwort

JSON
{
  "message": "Success",
  "output": [
    { "url": "https://img.pedra.ai/<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.
preserveAspectRatioboolean
Standardmäßig wird das Ergebnis in der Größe zurückgegeben, die das KI-Modell erzeugt – diese kann vom Seitenverhältnis und der Auflösung Ihres Fotos abweichen. Auf true setzen, um das Ergebnis in exakt der Breite und Höhe des Eingabebildes zu erhalten: Es wird mittig auf das ursprüngliche Seitenverhältnis zugeschnitten (nie gestreckt) und auf die ursprüngliche Auflösung skaliert.
Default: false
propertyIdstring
Optionale Id der Immobilie (von list_properties oder create_property), zu der dieses Foto gehört. Wenn angegeben, wird das Ergebnis in der Galerie dieser Immobilie gespeichert — sichtbar und in der App bearbeitbar — statt nur als URL zurückgegeben zu werden. Die Antwort enthält dann zusätzlich <code>source</code> (<code>imageId</code> und <code>name</code>) des Originalfotos, sofern es bereits in dieser Immobilie liegt oder Sie zusätzlich <code>name</code> senden.
namestring
Optionaler Name für das Originalfoto (z. B. der Dateiname), bis zu 200 Zeichen. Erfordert <code>propertyId</code>. Liegt das Foto noch nicht in dieser Immobilie, wird es im selben Aufruf unter diesem Namen dort gespeichert, ein vorheriges <code>add_images_to_property</code> ist also nicht nötig, und der Name wird als <code>source.name</code> zurückgegeben. Ein Foto, das bereits in der Immobilie liegt, behält seinen Namen. Erscheint nie auf dem Bild.

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://img.pedra.ai/<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). Akzeptiert dieselben vordefinierten Raumtypen wie der furnish-Endpunkt sowie jeden benutzerdefinierten Raum, den Sie als String angeben (z. B. "Kid's room", "Garden", "Home gym").
Values: Living room Dining + Living room Bedroom Dining room Terrace Entrance Office Bathroom Auto
Default: Auto
creativitystring
Veraltet und seit September 2026 ignoriert. Die Renovierung hat jetzt nur noch eine Stufe: Sie erneuert Oberflächen, Materialien und Möbel und lässt Wände, Türen, Fenster und den Kamerawinkel exakt unverändert, für 1 Credit pro Bild. Anfragen, die diesen Parameter noch senden, funktionieren weiterhin.
preserveAspectRatioboolean
Standardmäßig wird das Ergebnis in der Größe zurückgegeben, die das KI-Modell erzeugt – diese kann vom Seitenverhältnis und der Auflösung Ihres Fotos abweichen. Auf true setzen, um das Ergebnis in exakt der Breite und Höhe des Eingabebildes zu erhalten: Es wird mittig auf das ursprüngliche Seitenverhältnis zugeschnitten (nie gestreckt) und auf die ursprüngliche Auflösung skaliert.
Default: false
propertyIdstring
Optionale Id der Immobilie (von list_properties oder create_property), zu der dieses Foto gehört. Wenn angegeben, wird das Ergebnis in der Galerie dieser Immobilie gespeichert — sichtbar und in der App bearbeitbar — statt nur als URL zurückgegeben zu werden. Die Antwort enthält dann zusätzlich <code>source</code> (<code>imageId</code> und <code>name</code>) des Originalfotos, sofern es bereits in dieser Immobilie liegt oder Sie zusätzlich <code>name</code> senden.
namestring
Optionaler Name für das Originalfoto (z. B. der Dateiname), bis zu 200 Zeichen. Erfordert <code>propertyId</code>. Liegt das Foto noch nicht in dieser Immobilie, wird es im selben Aufruf unter diesem Namen dort gespeichert, ein vorheriges <code>add_images_to_property</code> ist also nicht nötig, und der Name wird als <code>source.name</code> zurückgegeben. Ein Foto, das bereits in der Immobilie liegt, behält seinen Namen. Erscheint nie auf dem Bild.

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

Beispielantwort

JSON
{
  "message": "Success",
  "output": [
    { "url": "https://img.pedra.ai/<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".
preserveAspectRatioboolean
Standardmäßig wird das Ergebnis in der Größe zurückgegeben, die das KI-Modell erzeugt – diese kann vom Seitenverhältnis und der Auflösung Ihres Fotos abweichen. Auf true setzen, um das Ergebnis in exakt der Breite und Höhe des Eingabebildes zu erhalten: Es wird mittig auf das ursprüngliche Seitenverhältnis zugeschnitten (nie gestreckt) und auf die ursprüngliche Auflösung skaliert.
Default: false
propertyIdstring
Optionale Id der Immobilie (von list_properties oder create_property), zu der dieses Foto gehört. Wenn angegeben, wird das Ergebnis in der Galerie dieser Immobilie gespeichert — sichtbar und in der App bearbeitbar — statt nur als URL zurückgegeben zu werden. Die Antwort enthält dann zusätzlich <code>source</code> (<code>imageId</code> und <code>name</code>) des Originalfotos, sofern es bereits in dieser Immobilie liegt oder Sie zusätzlich <code>name</code> senden.
namestring
Optionaler Name für das Originalfoto (z. B. der Dateiname), bis zu 200 Zeichen. Erfordert <code>propertyId</code>. Liegt das Foto noch nicht in dieser Immobilie, wird es im selben Aufruf unter diesem Namen dort gespeichert, ein vorheriges <code>add_images_to_property</code> ist also nicht nötig, und der Name wird als <code>source.name</code> zurückgegeben. Ein Foto, das bereits in der Immobilie liegt, behält seinen Namen. Erscheint nie auf dem Bild.

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://img.pedra.ai/<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.
preserveAspectRatioboolean
Standardmäßig wird das Ergebnis in der Größe zurückgegeben, die das KI-Modell erzeugt – diese kann vom Seitenverhältnis und der Auflösung Ihres Fotos abweichen. Auf true setzen, um das Ergebnis in exakt der Breite und Höhe des Eingabebildes zu erhalten: Es wird mittig auf das ursprüngliche Seitenverhältnis zugeschnitten (nie gestreckt) und auf die ursprüngliche Auflösung skaliert.
Default: false
propertyIdstring
Optionale Id der Immobilie (von list_properties oder create_property), zu der dieses Foto gehört. Wenn angegeben, wird das Ergebnis in der Galerie dieser Immobilie gespeichert — sichtbar und in der App bearbeitbar — statt nur als URL zurückgegeben zu werden. Die Antwort enthält dann zusätzlich <code>source</code> (<code>imageId</code> und <code>name</code>) des Originalfotos, sofern es bereits in dieser Immobilie liegt oder Sie zusätzlich <code>name</code> senden.
namestring
Optionaler Name für das Originalfoto (z. B. der Dateiname), bis zu 200 Zeichen. Erfordert <code>propertyId</code>. Liegt das Foto noch nicht in dieser Immobilie, wird es im selben Aufruf unter diesem Namen dort gespeichert, ein vorheriges <code>add_images_to_property</code> ist also nicht nötig, und der Name wird als <code>source.name</code> zurückgegeben. Ein Foto, das bereits in der Immobilie liegt, behält seinen Namen. Erscheint nie auf dem Bild.

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://img.pedra.ai/<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.