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.
preserveOriginalFramingboolean
Behält das genaue ursprüngliche Seitenverhältnis und die Komposition bei. Setzen Sie true für Portale mit strengen Bildvorgaben.
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",
    "preserveOriginalFraming": 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.
preserveOriginalFramingboolean
Wenn true, behält die Pipeline die Komposition, das Seitenverhältnis und die Auflösung der Eingabe exakt bei (ohne Randbeschnitt). Entwickelt für Verifikations-Verticals, in denen die Ausgabe das aufgenommene Foto rechtlich repräsentieren muss.
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.