SDK

SDK officiels Python et JavaScript/TypeScript pour l'API Pedra. Home staging virtuel, rénovation, amélioration d'images et vidéos d'annonces en quelques lignes de code — chaque méthode attend que le rendu soit prêt et renvoie l'URL finale.

SDK officiels

Deux clients officiels encapsulent l'API REST de Pedra. Tous deux sont open source, sans dépendances à l'exécution, et exposent chaque endpoint. Chaque méthode attend que le rendu soit prêt et renvoie la ou les URL finales — aucun ID de tâche à interroger.

Installation

Node.js

npm install @pedra-ai/sdk

Python

pip install pedra

Authentification

Passez votre clé au client ou définissez la variable d'environnement PEDRA_API_KEY. Obtenez une clé en vous inscrivant sur app.pedra.ai et en ouvrant Paramètres → API. Les clés ont une longue durée de vie — ne les déployez jamais côté client ; appelez depuis votre backend. Voir Authentification pour les détails.

from pedra import Pedra

# Reads PEDRA_API_KEY from the environment…
pedra = Pedra()

# …or pass the key explicitly
pedra = Pedra("YOUR_API_KEY")

Démarrage rapide

Meublez une pièce vide. Chaque méthode d'image renvoie la même forme — lisez url pour le premier rendu ou urls pour tous.

from pedra import Pedra

pedra = Pedra()  # reads PEDRA_API_KEY

result = pedra.furnish(
    image_url="https://example.com/empty-living-room.jpg",
    room_type="Living room",
    style="Minimalist",
)

print(result.url)   # the staged image URL
print(result.urls)  # all generated URLs

Ce que vous pouvez appeler

Les deux SDK couvrent chaque endpoint Pedra avec les mêmes noms de méthode dans les deux langages :

• furnish, empty, renovation, editViaPrompt, remove — voir Home staging virtuel.
• enhance, enhanceAndCorrectPerspective, sky, blur — voir Amélioration d'images.
• createVideo, updateVideo, generateVoiceScript, generateVoice, musicLibrary, ainsi que credits et feedback — voir Vidéo et Crédits.
• listProperties, listPropertyImages, createProperty, addImagesToProperty — voir Propriétés.

Python utilise le snake_case (edit_via_prompt, create_video, update_video, generate_voice, music_library) ; les paramètres et le comportement sont identiques.

Gestion des erreurs

Les deux SDK lèvent PedraApiError pour les échecs de l'API (avec status et body) et PedraError pour les erreurs client/réseau. Voir Erreurs et limites pour la liste complète des modes d'échec.

Serveur MCP

Vous préférez piloter Pedra depuis un assistant IA ? Le serveur MCP officiel de Pedra expose les mêmes opérations à Claude, ChatGPT et Cursor, pour stager et retoucher les photos d'annonces directement depuis un chat.

Code source & support

Les deux SDK sont sous licence MIT et développés ouvertement. Ajoutez une étoile ou ouvrez des issues sur GitHub, et écrivez à felix@pedra.ai pour de l'aide d'intégration, des quotas plus élevés ou des conditions enterprise.

Questions fréquentes