pedra.ai API-Dokumentation

API zur Erstellung virtueller Home-Staging-Bilder

Willkommen zur offiziellen Dokumentation der pedra.ai 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.ai/api

Authentification

Tous les appels API nécessitent un paramètre apiKey pour l'authentification. Envoyez un email à felix@pedra.ai 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): Bild-URL (http/https) oder base64-Daten-URI (data:image/...).

API-Endpoints

Verbesserung ausführen

Verbessert Qualität, Farbe, Licht und Auflösung des bereitgestellten Bildes.

Endpoint: /enhance

Method: POST

Parameters:

{
  "apiKey": "string",
  "imageUrl": "string"
}

Expected response time: 25 Sekunden

Leeren Raum ausführen

Entfernt Möbel und Unordnung aus dem Raum im bereitgestellten Bild.

Endpoint: /empty_room

Method: POST

Parameters:

{
  "apiKey": "string",
  "imageUrl": "string"
}

Expected response time: 25 Sekunden

Möblierung ausführen

Möbliert (erstellt virtuelles Staging) eines Raumes nach spezifizierten Parametern.

Endpoint: /furnish

Method: POST

Parameters:

{
  "apiKey": "string",
  "imageUrl": "string",
  "roomType": "string",
  "style": "string",
  "creativity": "Medium" | "High"
}

Expected response time: 25 Sekunden

roomType (string):

You can write any room type (e.g., "Living room", "Bedroom", "Kitchen", "Office", etc.)

Example 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:

{
  "apiKey": "string",
  "imageUrl": "string",
  "creativity": "Medium" | "High",
  "furnish": true | false,
  "style": "string",
  "roomType": "string"
}

Expected response time: 25 Sekunden

roomType and style:

Same options as the Furnish endpoint above.

Himmel Blau

Verbessert den Himmel in Außenaufnahmen und lässt ihn blau und lebendig erscheinen.

Endpoint: /sky_blue

Method: POST

Parameters:

{
  "apiKey": "string",
  "imageUrl": "string"
}

Expected response time: ~15 Sekunden

Mit Prompt Bearbeiten

Bearbeitet das Bild basierend auf einer natürlichsprachigen Eingabe, die die gewünschten Änderungen beschreibt.

Endpoint: /edit_via_prompt

Method: POST

Parameters:

{
  "apiKey": "string",
  "imageUrl": "string",
  "prompt": "string"
}

Expected response time: ~20 Sekunden

Objekt Entfernen

Entfernt Objekte aus dem Bild mithilfe einer Maske, um anzugeben, welche Bereiche entfernt werden sollen.

Endpoint: /remove_object

Method: POST

Parameters:

{
  "apiKey": "string",
  "imageUrl": "string",
  "maskUrl": "string"
}

Expected response time: ~15 Sekunden

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 felix@pedra.ai.