SDKs

Offizielle Python- und JavaScript/TypeScript-SDKs für die Pedra-API. Virtuelles Home Staging, Renovierung, Bildverbesserung und Anzeigenvideos in wenigen Codezeilen — jede Methode wartet, bis das Ergebnis fertig ist, und gibt die finale URL zurück.

Offizielle SDKs

Zwei offizielle Clients kapseln die Pedra-REST-API. Beide sind quelloffen, haben keine Laufzeitabhängigkeiten und stellen jeden Endpunkt bereit. Jede Methode wartet, bis das Ergebnis fertig ist, und gibt die finale(n) URL(s) zurück — keine Job-IDs zum Abfragen.

Installation

Node.js

npm install @pedra-ai/sdk

Python

pip install pedra

Authentifizierung

Übergeben Sie Ihren Schlüssel an den Client oder setzen Sie die Umgebungsvariable PEDRA_API_KEY. Holen Sie sich einen Schlüssel, indem Sie sich auf app.pedra.ai registrieren und Einstellungen → API öffnen. Schlüssel sind langlebig — verteilen Sie sie niemals im Client-Code; rufen Sie von Ihrem Backend aus auf. Siehe Authentifizierung für Details.

from pedra import Pedra

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

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

Schnellstart

Möblieren Sie einen leeren Raum. Jede Bildmethode gibt dieselbe Struktur zurück — lesen Sie url für das erste Ergebnis oder urls für alle.

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

Was Sie aufrufen können

Beide SDKs decken jeden Pedra-Endpunkt mit denselben Methodennamen über beide Sprachen ab:

• furnish, empty, renovation, editViaPrompt, remove — siehe Virtuelles Home Staging.
• enhance, enhanceAndCorrectPerspective, sky, blur — siehe Bildverbesserung.
• createVideo, updateVideo, generateVoiceScript, generateVoice, musicLibrary sowie credits und feedback — siehe Video und Credits.
• listProperties, listPropertyImages, createProperty, addImagesToProperty — siehe Immobilien.

Python verwendet snake_case (edit_via_prompt, create_video, update_video, generate_voice, music_library); Parameter und Verhalten sind identisch.

Fehlerbehandlung

Beide SDKs werfen PedraApiError bei API-Fehlern (mit status und body) und PedraError bei Client-/Netzwerkfehlern. Siehe Fehler und Limits für die vollständige Liste der Fehlermodi.

MCP-Server

Möchten Sie Pedra lieber aus einem KI-Assistenten heraus steuern? Der offizielle Pedra-MCP-Server stellt dieselben Operationen für Claude, ChatGPT und Cursor bereit, sodass Sie Anzeigenfotos direkt aus einem Chat stagen und bearbeiten können.

Quellcode & Support

Beide SDKs sind MIT-lizenziert und werden offen entwickelt. Vergeben Sie einen Stern oder öffnen Sie Issues auf GitHub und schreiben Sie an felix@pedra.ai für Integrationshilfe, höhere Quoten oder Enterprise-Bedingungen.

Häufige Fragen