Pedra.so API-Dokumentation
API zur Erstellung virtueller Home-Staging-Bilder
Willkommen zur offiziellen Dokumentation der Pedra.so API. Unsere API bietet leistungsstarke Bildverarbeitungsfähigkeiten für verschiedene Raumverbesserungs- und Designaufgaben.
URLs Base
L'API peut être accédée via l'URL de base suivante :
- Production:
https://app.pedra.so/api
Authentification
Tous les appels API nécessitent un paramètre apiKey pour l'authentification. Envoyez un email à felix@pedra.so pour demander votre clé API.
Paramètres Communs
Les paramètres suivants sont communs à tous les endpoints :
apiKey
(string, required): Votre clé API unique pour l'authentification.imageUrl
(string, required): URL de l'image à traiter.creativity
(string, required): Niveau de liberté créative pour l'IA.- Low: Préserve l'architecture originale avec des variations minimales.
- Medium: Maintient l'architecture originale avec des variations notables mais équilibrées.
API-Endpoints
Verbesserung ausführen
Verbessert Qualität, Farbe, Licht und Auflösung des bereitgestellten Bildes.
Endpoint: /enhance
Method: POST
Parameters: Gemeinsame Parameter (siehe oben)
Expected response time: Zwischen 25 Sekunden und 1 Minute
Leeren Raum ausführen
Entfernt Möbel und Unordnung aus dem Raum im bereitgestellten Bild.
Endpoint: /empty_room
Method: POST
Parameters: Gemeinsame Parameter (siehe oben)
Expected response time: Zwischen 2 und 3 Minuten
Möblierung ausführen
Möbliert (erstellt virtuelles Staging) eines Raumes nach spezifizierten Parametern.
Endpoint: /furnish
Method: POST
Parameters: Gemeinsame Parameter + roomType + style
Expected response time: Zwischen 2 und 3 Minuten
Possible values for roomType
:
- "Schlafzimmer"
- "Wohnzimmer"
- "Küche"
- "Büro"
- "Terrasse"
- "Salle à manger"
- "Küche + Wohnzimmer"
- "Salle à manger + Salon"
- "Entrée"
Possible values for style
:
- "Traditionell"
- "Minimalistisch"
- "Scandinave"
- "Mid-Century"
- "Bohème"
- "Industrial"
- "Mediterran"
- "Modern"
- "Pyrenéen"
Renovierung ausführen
Renoviert einen Raum nach dem spezifizierten Stil.
Endpoint: /renovation
Method: POST
Parameters: Gemeinsame Parameter + style + preserveWindows
Expected response time: Zwischen 25 Sekunden und 2 Minuten
Antwortformat
Alle API-Endpoints geben JSON-Antworten zurück. Eine erfolgreiche Antwort hat einen Statuscode 200 und enthält die verarbeiteten Bildinformationen.
Fehlerbehandlung
Im Fehlerfall gibt die API einen entsprechenden HTTP-Statuscode zusammen mit einer JSON-Antwort zurück, die Fehlerdetails enthält.
Support
Für Fragen oder Probleme bezüglich der API kontaktieren Sie bitte unser Support-Team unter <a href="mailto:felix@pedra.so" style="color: rgb(248, 121, 42); text-decoration: none;">felix@pedra.so</a>.