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.

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

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