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

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://pedraimages.s3.eu-west-3.amazonaws.com/<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

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

Himmel ersetzen

POST/api/sky_blue

Ersetzt einen grauen, bedeckten oder ausgewaschenen Himmel durch einen klaren blauen. Betrifft nur Himmel-Pixel — der Rest des Bildes bleibt unberührt.

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.

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

Beispielantwort

JSON

{
  "message": "Success",
  "output": {
    "url": "https://pedraimages.s3.eu-west-3.amazonaws.com/<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".

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://pedraimages.s3.eu-west-3.amazonaws.com/<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.