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>.