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.
• createVirtualTour, waitForVirtualTour, getVirtualTour, listVirtualTours, updateVirtualTour, addVirtualTourScenes, deleteVirtualTour, createUploadLink, addLocalPanoramas — siehe Virtuelle Rundgänge.

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

Virtuelle Rundgänge

Rundgänge sind der einzige asynchrone Ablauf: createVirtualTour kehrt sofort mit status: "processing" zurück, und waitForVirtualTour fragt ab, bis der Rundgang fertig ist (etwa 10 Sekunden pro Raum). Ein fehlgeschlagener Aufbau wird zurückgegeben, nicht geworfen — prüfen Sie status.

from pedra import Pedra

pedra = Pedra()

tour = pedra.create_virtual_tour(
    image_urls=[  # 360° photos, in walking order
        "https://example.com/360/entrance.jpg",
        "https://example.com/360/living-room.jpg",
        "https://example.com/360/kitchen.jpg",
    ],
    name="Calle Mayor 12",
)
tour = pedra.wait_for_virtual_tour(tour.tour_id)

if tour.status == "ready":
    print(tour.tour_url)    # shareable tour page
    print(tour.embed_code)  # <iframe> for a listing page

Noch kein API-Schlüssel?

Ein Agent oder Skript kann einen für die Person bekommen, für die er arbeitet — und ihr bei Bedarf ein Pedra-Konto anlegen. requestAccess schickt ihr einen Bestätigungslink per E-Mail (ohne Schlüssel); waitForAccess fragt ab, bis sie zustimmt, und liefert den apiKey. Beide gibt es auch als statische Methoden von Pedra. Siehe Konten für KI-Agenten.

from pedra import Pedra, request_access, wait_for_access

req = request_access("maria@example.com", agent_name="My listing assistant")
print("Check your email and click the link from Pedra.")

res = wait_for_access(req.request_id)  # polls every 5 s, up to 30 min
if res.approved:
    if res.note:
        print(res.note)  # only when there are no credits left
    pedra = Pedra(res.api_key)  # store the key; it doesn't expire

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