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. Wenn true, wird preserveOriginalFraming ignoriert.
Default: false
preserveOriginalFramingboolean
Behält Bildausschnitt, Seitenverhältnis und Auflösung des Originals exakt bei (ohne Randbeschnitt). Die Verbesserung ist weiterhin KI-generiert, daher können sich Farben und Materialien leicht ändern — müssen sie identisch bleiben, verwenden Sie highFidelity. Wird ignoriert, wenn highFidelity true ist.
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.

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. Wenn true, wird preserveOriginalFraming ignoriert.
Default: false
preserveOriginalFramingboolean
Behält Bildausschnitt, Seitenverhältnis und Auflösung der Eingabe exakt bei (ohne Randbeschnitt) und korrigiert dabei die Perspektive. Die Verbesserung ist weiterhin KI-generiert, daher können sich Farben und Materialien leicht ändern — verwenden Sie highFidelity, wenn sie identisch bleiben müssen. Wird ignoriert, wenn highFidelity true ist.
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.

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
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.

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".
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.

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.