Bildverbesserung

API zur Bildverbesserung

Automatische Verbesserung, Perspektivkorrektur, Himmel-Ersatz und Verwischung — Endpunkte zum Bereinigen von Immobilienfotos.

Die Bildverbesserungs-Endpunkte beheben häufige Probleme bei Anzeigenfotos: trübes Licht, gekippte Perspektive, graue Himmel und datenschutzsensible Inhalte. Jeder akzeptiert eine Bild-URL und gibt das verarbeitete Ergebnis zurück.

Automatische Verbesserung

POST/api/enhance

Verbessert automatisch Beleuchtung, Farbbalance, Schärfe und Kontrast. Verwenden Sie ihn als Standard-Bereinigungspass für unbearbeitete Anzeigenfotos.

Beispiele für Bildverbesserung
Echte Anzeigenfotos vor und nach dem Enhance-Pass — dunkle Räume, blasse Farben, weicher Fokus.
Beispiele ansehen →

Parameter

apiKeystringerforderlich
Ihr API-Schlüssel.
imageUrlstringerforderlich
URL des zu verbessernden Fotos oder ein base64-data-URI.
highFidelityboolean
Nicht-generative Verbesserung: passt nur Licht und Schärfe an und behält Farben, Materialien, Objektgrößen und Bildausschnitt exakt wie im Originalfoto bei. Ideal, wenn das Ergebnis dem Original originalgetreu entsprechen muss.
Default: false
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/enhance \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/listing-photo.jpg",
    "highFidelity": true
  }'

Beispielantwort

JSON
{
  "message": "Success",
  "output": [
    { "url": "https://img.pedra.ai/<generated-id>" }
  ]
}

Antwortzeit: ~10 Sekunden pro Bild. Die Antwort kann mehrere URLs enthalten, wenn das Modell Varianten erzeugt.

Verbessern + Perspektive korrigieren

POST/api/enhance_and_correct_perspective

Wie /api/enhance, aber mit einem vorgelagerten Perspektivkorrektur-Pass, der senkrechte Linien gerade richtet. Verwenden Sie ihn, wenn Anzeigenfotos mit einem nach oben oder unten geneigten Handy aufgenommen wurden.

Beispiele für Bildverbesserung
Gleiche Galerie wie /api/enhance — Perspektivkorrektur ist am sichtbarsten bei gekippten Außenaufnahmen.
Beispiele ansehen →

Parameter

apiKeystringerforderlich
Ihr API-Schlüssel.
imageUrlstringerforderlich
URL des Fotos oder ein base64-data-URI.
highFidelityboolean
Nicht-generative Verbesserung mit Perspektivkorrektur: passt nur Licht, Schärfe und Perspektive an und behält Farben, Materialien und Objektgrößen exakt wie im Original bei.
Default: false
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.

Antwortformat: wie /api/enhance (Array). Antwortzeit: ~15 Sekunden pro Bild.

Himmel ersetzen

POST/api/sky_blue

Ersetzt einen grauen, bedeckten oder ausgewaschenen Himmel und verbessert die Beleuchtung. Standardmäßig ein klarer blauer Himmel; verwenden Sie skyStyle, um eine andere Tageszeit zu wählen (Sonnenaufgang, Sonnenuntergang, Nacht).

Beispiele für Bildverbesserung
Bedeckte Außenaufnahmen verwandelt in Anzeigenfotos mit klarem blauen Himmel.
Beispiele ansehen →

Parameter

apiKeystringerforderlich
Ihr API-Schlüssel.
imageUrlstringerforderlich
URL des Außenfotos oder ein base64-data-URI.
skyStylestring
Welcher Himmel und welche Beleuchtung angewendet werden. Standardmäßig "sunny". Optionen: "sunny" (heller, klarer blauer Himmel), "sunny-no-reflections" (blauer Himmel mit weichem, gleichmäßigem Licht — ideal für schattige oder nach Norden ausgerichtete Außenbereiche), "sunrise" (warmer goldener Morgen), "dawn" (Sonnenuntergangs- / Dämmerungstöne), "night" (Dämmerung mit warmer Innen- und Fassadenbeleuchtung).
Values: sunny sunny-no-reflections sunrise dawn night
Default: sunny
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/sky_blue \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/exterior-photo.jpg",
    "skyStyle": "sunny"
  }'

Beispielantwort

JSON
{
  "message": "Success",
  "output": {
    "url": "https://img.pedra.ai/<generated-id>"
  }
}

Antwortzeit: ~10 Sekunden pro Bild. Hinweis: output ist hier ein einzelnes Objekt, kein Array.

Objekte verwischen

POST/api/blur

Verwischt automatisch sensible Inhalte wie Gesichter, Kennzeichen oder Marken-Logos. Nützlich für portalkonforme Außenaufnahmen.

Parameter

apiKeystringerforderlich
Ihr API-Schlüssel.
imageUrlstringerforderlich
URL des Quellfotos.
objectsToBlurstringerforderlich
Kommaseparierte Liste dessen, was verwischt werden soll. Beispiele: "faces", "license plates", "logos", "faces, license plates".
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/blur \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/photo.jpg",
    "objectsToBlur": "faces, license plates"
  }'

Beispielantwort

JSON
{
  "message": "Success",
  "output": {
    "url": "https://img.pedra.ai/<generated-id>"
  }
}

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

Weiter

Siehe Virtuelles Home Staging für Möbel- und Inhaltsbearbeitung oder Video erstellen für die Generierung von Anzeigenvideos aus Fotos.