Référence API

API Pedra

Accès programmatique au home staging virtuel, à l'amélioration d'images et à la génération de vidéos immobilières. JSON via HTTPS. Pour portails, CRMs et plateformes immobilières.

URL de base

Toutes les requêtes API se font vers :

https://app.pedra.ai/api

Démarrage rapide

Chaque endpoint accepte un POST JSON avec votre apiKey et une imageUrl. Voici un appel de home staging virtuel qui meuble une pièce vide :

curl -X POST https://app.pedra.ai/api/furnish \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/empty-room.jpg",
    "roomType": "Living room",
    "style": "Minimalist"
  }'

Les réponses réussies renvoient HTTP 200 avec { "message": "...", "output": ... }. output est un tableau pour /api/enhance, /api/enhance_and_correct_perspective, /api/empty_room, /api/furnish et /api/renovation, et un objet unique pour /api/sky_blue, /api/edit_via_prompt, /api/remove_object et /api/blur. Voir Erreurs et limites pour les formats d'échec.

SDK & MCP

Vous préférez un client typé au HTTP brut ? Les SDK officiels Python et Node.js encapsulent chaque endpoint — pip install pedra ou npm i @pedra-ai/sdk. Ou appelez Pedra directement depuis Claude, ChatGPT et Cursor via le serveur MCP. Besoin d'un contrat lisible par machine ? Téléchargez la spécification OpenAPI 3.1.

Endpoints

Voir chaque endpoint en action
Parcourez les galeries avant/après de staging, rénovation, amélioration, remplacement de ciel et vidéo.
Voir les exemples →

Home staging virtuel →

POST/api/furnishAjoute des meubles à une pièce vide
POST/api/empty_roomSupprime tout le mobilier d'une pièce
POST/api/renovationRénove une pièce dans un nouveau style
POST/api/edit_via_promptModifie une image avec un prompt
POST/api/remove_objectSupprime des objets spécifiques via un masque

Amélioration d'images →

POST/api/enhanceAmélioration automatique de la lumière, couleur, netteté
POST/api/enhance_and_correct_perspectiveAméliorer + redresser les lignes verticales
POST/api/sky_blueRemplace un ciel gris par un ciel bleu
POST/api/blurFloute des objets (visages, plaques, logos)

Vidéo →

POST/api/create_videoGénère une vidéo d'annonce à partir de photos

Compte →

POST/api/creditsConsulte le solde de crédits restant
POST/api/feedbackÉvaluez une image et demandez un remboursement de crédits

Authentification

Toutes les requêtes nécessitent une apiKey dans le corps JSON. Obtenez une clé en vous inscrivant sur app.pedra.ai et en ouvrant Paramètres → API. Voir Authentification pour les détails.

Format des requêtes et des réponses

Chaque endpoint accepte du JSON via HTTPS en POST. Les images peuvent être passées en URL publiquement accessible ou en URI data base64 (data:image/png;base64,...). Pedra fait timeout après 20s lors du téléchargement de imageUrl — pour les URLs avec authentification ou présignées (S3, R2, Cloudinary), préférez le format base64.

Tous les endpoints sont synchrones. Les endpoints d'image répondent en ~10–30 secondes ; l'endpoint vidéo bloque jusqu'à 10 minutes — configurez le timeout de votre client HTTP en conséquence.

Tarification

L'utilisation de l'API est facturée par requête, avec des remises selon le volume. Voir Tarification.

Support

Écrivez à felix@pedra.ai pour augmenter les quotas, obtenir de l'aide d'intégration ou des conditions enterprise. Nous répondons sous un jour ouvré.

Questions fréquentes

Pedra a-t-il une API ?

Oui. Pedra propose une API REST en JSON-over-HTTPS pour le home staging virtuel, l'amélioration d'images, la suppression d'objets et la génération de vidéos d'annonces. Elle est conçue pour les plateformes immobilières, les CRM et les portails. Obtenez une clé API sur app.pedra.ai dans Paramètres → API.

Que peut faire l'API Pedra ?

Elle expose toutes les transformations Pedra de façon programmatique : meubler des pièces vides, vider des pièces meublées, rénover des espaces, éditer des photos avec une instruction textuelle, supprimer des objets, améliorer la lumière et les couleurs, corriger la perspective, remplacer le ciel, flouter du contenu sensible et générer des vidéos d'annonces.

Existe-t-il une API de home staging virtuel ?

Oui. POST /api/furnish ajoute des meubles aux pièces vides, /api/empty_room les retire, /api/renovation change le style d'un espace et /api/edit_via_prompt édite une photo à partir d'une instruction en langage naturel — le tout dans une seule API JSON.

Comment intégrer Pedra ?

Créez une clé API, puis installez un SDK officiel (pip install pedra ou npm install @pedra-ai/sdk) ou appelez directement les endpoints REST. Transmettez votre clé et l'URL d'une image à un endpoint ; chaque appel attend que le résultat soit prêt et renvoie l'URL finale — aucun ID de tâche à interroger.

Combien coûte l'API Pedra ?

La tarification est à la génération réussie avec des remises sur volume, et vous ne payez que pour les résultats réussis. Un essai gratuit est disponible. Consultez la page de tarification de l'API pour plus de détails.

Comment fonctionne l'authentification de l'API Pedra ?

Vous transmettez votre clé API dans le corps de la requête, dans le champ apiKey. Les clés ont une longue durée de vie : appelez l'API depuis votre backend et n'intégrez jamais de clé dans du code côté client.