API-Referenz

Pedra API

Programmatischer Zugriff auf virtuelles Home Staging, Bildverbesserung und Immobilienvideo-Generierung. JSON über HTTPS. Für Immobilienportale, CRMs und Plattformen.

Basis-URL

Alle API-Anfragen gehen an:

https://app.pedra.ai/api

Schnellstart

Jeder Endpunkt akzeptiert einen JSON-POST mit Ihrem apiKey und einer imageUrl. Hier ist ein virtueller Home-Staging-Aufruf, der einen leeren Raum möbliert:

curl -X POST https://app.pedra.ai/api/furnish \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/empty-room.jpg",
    "roomType": "Living room",
    "style": "Minimalist"
  }'

Erfolgreiche Antworten liefern HTTP 200 mit { "message": "...", "output": ... }. output ist ein Array für /api/enhance, /api/enhance_and_correct_perspective, /api/empty_room, /api/furnish und /api/renovation, und ein einzelnes Objekt für /api/sky_blue, /api/edit_via_prompt, /api/remove_object und /api/blur. Siehe Fehler und Limits für Fehlerformate.

Endpunkte

Jeden Endpunkt in Aktion sehen
Durchstöbern Sie Vorher/Nachher-Galerien für Staging, Renovierung, Verbesserung, Himmel-Ersatz und Video.
Beispiele ansehen →

Virtuelles Home Staging →

POST/api/furnishMöbliert einen leeren Raum
POST/api/empty_roomEntfernt alle Möbel aus einem Raum
POST/api/renovationRenoviert einen Raum in einem neuen Stil
POST/api/edit_via_promptBearbeitet ein Bild per Text-Prompt
POST/api/remove_objectEntfernt bestimmte Objekte über eine Maske

Bildverbesserung →

POST/api/enhanceAutomatische Verbesserung von Licht, Farbe, Schärfe
POST/api/enhance_and_correct_perspectiveVerbessern + senkrechte Linien begradigen
POST/api/sky_blueErsetzt einen grauen Himmel durch blau
POST/api/blurVerwischt Objekte (Gesichter, Kennzeichen, Logos)

Video →

POST/api/create_videoErstellt ein Anzeigenvideo aus Fotos

Konto →

POST/api/creditsPrüft das verbleibende Credit-Guthaben

Authentifizierung

Alle Anfragen erfordern einen apiKey im JSON-Body. Holen Sie sich einen Schlüssel, indem Sie sich auf app.pedra.ai registrieren und Einstellungen → API öffnen. Siehe Authentifizierung für Details.

Anfrage- und Antwortformat

Jeder Endpunkt akzeptiert JSON über HTTPS per POST. Bildeingaben können als öffentlich zugängliche URL oder als base64-data-URI (data:image/png;base64,...) übergeben werden. Pedra macht nach 20s Timeout beim Herunterladen von imageUrl — für authentifizierte oder vorsignierte URLs (S3, R2, Cloudinary) bevorzugen Sie die base64-Form.

Alle Endpunkte sind synchron. Bild-Endpunkte antworten in ~10–30 Sekunden; der Video-Endpunkt blockiert bis zu 10 Minuten — setzen Sie das Timeout Ihres HTTP-Clients entsprechend.

Preise

Die API-Nutzung wird pro Anfrage abgerechnet, mit Mengenrabatten. Siehe Preise.

Support

Senden Sie eine E-Mail an felix@pedra.ai für Quota-Erhöhungen, Integrationshilfe oder Enterprise-Bedingungen. Wir antworten innerhalb eines Werktags.