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