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. Jeder Bild-Endpunkt verarbeitet genau ein Bild, daher enthält das Array immer genau ein Element. Siehe Fehler und Limits für Fehlerformate.

SDKs & MCP

Lieber ein typisierter Client statt rohem HTTP? Die offiziellen Python- und Node.js-SDKs kapseln jeden Endpunkt — pip install pedra oder npm i @pedra-ai/sdk. Oder rufen Sie Pedra direkt aus Claude, ChatGPT und Cursor über den MCP-Server auf. Brauchen Sie einen maschinenlesbaren Vertrag? Laden Sie die OpenAPI-3.1-Spezifikation herunter.

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

Virtuelle Rundgänge →

POST/api/create_virtual_tourErstellt einen gehosteten virtuellen 360°-Rundgang aus 360°-Fotos
POST/api/get_virtual_tourFragt den Status eines Rundgangs ab; liefert Räume und Links
POST/api/create_upload_linkSeite ohne Login zum Hochladen von Fotos und 360°-Fotos vom Handy

Social Media →

POST/api/social/accountsZeigt, welche sozialen Netzwerke verbunden sind
POST/api/social/postsPostet oder plant ein Video auf Instagram, Facebook, TikTok und YouTube
POST/api/social/posts/listListet Beiträge und ihren Status auf
POST/api/social/posts/cancelStorniert einen geplanten Beitrag

Konto →

POST/api/creditsPrüft das verbleibende Credit-Guthaben
POST/api/feedbackBewerten Sie ein Bild und fordern Sie Credits zurück

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. Einzige Ausnahme sind virtuelle Rundgänge: create_virtual_tour antwortet sofort, und Sie fragen get_virtual_tour ab.

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.

Häufige Fragen

Hat Pedra eine API?

Ja. Pedra bietet eine JSON-over-HTTPS-REST-API für virtuelles Home Staging, Bildverbesserung, Objektentfernung und die Erstellung von Anzeigenvideos. Sie ist für Immobilienplattformen, CRMs und Portale gedacht. Einen API-Schlüssel erhältst du auf app.pedra.ai unter Einstellungen → API.

Was kann die Pedra-API?

Sie stellt alle Pedra-Transformationen programmatisch bereit: leere Räume möblieren, möblierte Räume leeren, Räume renovieren, Fotos per Texteingabe bearbeiten, Objekte entfernen, Licht und Farbe verbessern, Perspektive korrigieren, Himmel ersetzen, sensible Inhalte unkenntlich machen und Anzeigenvideos erstellen.

Gibt es eine API für virtuelles Home Staging?

Ja. POST /api/furnish möbliert leere Räume, /api/empty_room entfernt Möbel, /api/renovation gestaltet einen Raum neu und /api/edit_via_prompt bearbeitet ein Foto anhand einer Anweisung in normaler Sprache — alles in einer JSON-API.

Wie integriere ich Pedra?

Erstelle einen API-Schlüssel und installiere dann ein offizielles SDK (pip install pedra oder npm install @pedra-ai/sdk) oder rufe die REST-Endpunkte direkt auf. Übergib deinen Schlüssel und eine Bild-URL an einen Endpunkt; jeder Aufruf wartet, bis das Ergebnis fertig ist, und gibt die finale URL zurück — keine Job-IDs zum Abfragen.

Was kostet die Pedra-API?

Die Abrechnung erfolgt pro erfolgreicher Generierung mit Mengenrabatten, und du zahlst nur für erfolgreiche Ergebnisse. Eine kostenlose Testphase ist verfügbar. Details findest du auf der API-Preisseite.

Wie funktioniert die Authentifizierung der Pedra-API?

Du übergibst deinen API-Schlüssel im Anfragetext als Feld apiKey. Schlüssel sind langlebig — rufe die API daher von deinem Backend aus auf und gib niemals einen Schlüssel im Client-Code preis.