Documentation API pedra.ai

API pour créer des images de staging virtuel

Bienvenue dans la documentation officielle de l'API pedra.ai. 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.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): URL de l'image (http/https) ou URI de données base64 (data:image/...).

Endpoints API

Améliorer

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

Endpoint: /enhance

Method: POST

Parameters:

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

Expected response time: 25 secondes

Vider la Pièce

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

Endpoint: /empty_room

Method: POST

Parameters:

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

Expected response time: 25 secondes

Meubler

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

Endpoint: /furnish

Method: POST

Parameters:

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

Expected response time: 25 secondes

roomType (string):

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

Example values for style:

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

Rénovation

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 secondes

roomType and style:

Same options as the Furnish endpoint above.

Ciel Bleu

Améliore le ciel dans les images extérieures, le rendant bleu et vibrant.

Endpoint: /sky_blue

Method: POST

Parameters:

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

Expected response time: ~15 secondes

Éditer avec Prompt

Édite l'image en fonction d'un prompt en langage naturel décrivant les modifications souhaitées.

Endpoint: /edit_via_prompt

Method: POST

Parameters:

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

Expected response time: ~20 secondes

Supprimer un Objet

Supprime des objets de l'image en utilisant un masque pour spécifier les zones à supprimer.

Endpoint: /remove_object

Method: POST

Parameters:

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

Expected response time: ~15 secondes

Format de réponse

Tous les endpoints API renvoient des réponses JSON. Une réponse réussie aura un code d'état 200 et inclura les informations d'image traitées.

Gestion des erreurs

En cas d'erreur, l'API renverra un code d'état HTTP approprié avec une réponse JSON contenant les détails de l'erreur.

Support

Pour toute question ou problème concernant l'API, veuillez contacter notre équipe de support à felix@pedra.ai.