Documentation API Pedra.so

API pour créer des images de staging virtuel

Bienvenue dans la documentation officielle de l'API Pedra.so. Notre API fournit de puissantes capacités de traitement d'images pour diverses tâches d'amélioration et de conception de pièces.

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

Endpoints API

Exécuter Amélioration

Améliore la qualité, couleur, luz et résolution de l'image fournie.

Endpoint: /enhance

Method: POST

Parameters: Paramètres communs (voir ci-dessus)

Expected response time: Entre 25 secondes et 1 minute

Exécuter Pièce Vide

Supprime meubles et désordre de la pièce dans l'image fournie.

Endpoint: /empty_room

Method: POST

Parameters: Paramètres communs (voir ci-dessus)

Expected response time: Entre 2 et 3 minutes

Exécuter Ameublement

Meuble (crée un staging virtuel) d'un espace selon des paramètres spécifiés.

Endpoint: /furnish

Method: POST

Parameters: Paramètres communs + roomType + style

Expected response time: Entre 2 et 3 minutes

Possible values for roomType:

  • "Chambre"
  • "Salon"
  • "Cuisine"
  • "Bureau"
  • "Terrasse"
  • "Salle à manger"
  • "Cuisine + Salon"
  • "Salle à manger + Salon"
  • "Entrée"

Possible values for style:

  • "Traditionnel"
  • "Minimaliste"
  • "Scandinave"
  • "Mid-Century"
  • "Bohème"
  • "Industrial"
  • "Mediterran"
  • "Modern"
  • "Pyrenéen"

Exécuter Rénovation

Renoviert einen Raum nach dem spezifizierten Stil.

Endpoint: /renovation

Method: POST

Parameters: Paramètres communs + 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>.