Grundriss-API

Machen Sie aus einer Skizze, einem Foto oder Scan eines Grundrisses mit einem Aufruf einen sauberen, bearbeitbaren 2D-Grundriss. 5 Credits pro Grundriss, gespeichert in der Immobilie Ihrer Wahl.

Senden Sie eine Skizze, ein Foto oder einen Scan eines Grundrisses und erhalten Sie einen sauberen 2D-Grundriss zurück. Pedra liest Wände, Türen, Fenster und Raumnamen, richtet sie gerade aus und zeichnet einen Grundriss mit den Maßen, die auf der Zeichnung stehen. Der Grundriss wird in einer Immobilie gespeichert, sodass Ihre Nutzer ihn in Pedra öffnen und bearbeiten können wie einen selbst gezeichneten.

Kosten

5 Credits pro Grundriss, abgebucht nur, wenn ein Grundriss entsteht. Eine fehlgeschlagene Erkennung ist kostenlos. Hat das Konto weniger als 5 Credits, wird der Aufruf vor dem Start mit einem 403 abgelehnt, der das mitteilt.

Wo der Grundriss gespeichert wird

Wie bei Bildern und Videos: Übergeben Sie propertyId, um den Grundriss einer Ihrer Immobilien hinzuzufügen (aus list_properties oder create_property). Ohne sie legt Pedra eine neue Immobilie an, benannt nach propertyName. Die Antwort enthält immer die propertyId und eine appUrl, die sie in Pedra öffnet.

Grundriss erstellen

Das Lesen einer Zeichnung dauert etwa 1 bis 3 Minuten. Standardmäßig wartet der Aufruf und gibt den fertigen Grundriss zurück (die Verbindung bleibt währenddessen offen). Übergeben Sie "waitForCompletion": false, um sofort eine floorPlanId zu erhalten und stattdessen floor_plan_status abzufragen.

curl -X POST https://app.pedra.ai/api/create_floor_plan \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/sketches/calle-mayor-12.jpg",
    "propertyId": "196e742a-5b0d-4c9e-8a3f-7e2b1c6d9f04",
    "name": "Ground floor"
  }'

Antwort

{
  "message": "Floor plan created",
  "floorPlanId": "Ae6pgFD6yZyyhpzZH",
  "propertyId": "196e742a-5b0d-4c9e-8a3f-7e2b1c6d9f04",
  "name": "Ground floor",
  "status": "ready",
  "imageUrl": "https://img.pedra.ai/floorplan-source-QiqMn78cKtNHk4LpF",
  "appUrl": "https://app.pedra.ai/?projectId=196e742a-5b0d-4c9e-8a3f-7e2b1c6d9f04",
  "creditsUsed": 5
}

# 1. Start the conversion (returns at once with "status": "processing")
curl -X POST https://app.pedra.ai/api/create_floor_plan \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/sketches/calle-mayor-12.jpg",
    "propertyName": "Calle Mayor 12",
    "waitForCompletion": false
  }'

# 2. Poll every 10 seconds until "status" is "ready" (or "failed")
curl -X POST https://app.pedra.ai/api/floor_plan_status \
  -H "Content-Type: application/json" \
  -d '{ "apiKey": "YOUR_API_KEY", "floorPlanId": "FLOOR_PLAN_ID" }'

{
  "message": "Floor plan conversion started",
  "floorPlanId": "Ae6pgFD6yZyyhpzZH",
  "propertyId": "196e742a-5b0d-4c9e-8a3f-7e2b1c6d9f04",
  "name": "Ground floor",
  "status": "processing",
  "appUrl": "https://app.pedra.ai/?projectId=196e742a-5b0d-4c9e-8a3f-7e2b1c6d9f04"
}

Status des Grundrisses

Gibt "processing", "ready" (mit imageUrl) oder "failed" zurück. Verbraucht nie Credits.

curl -X POST https://app.pedra.ai/api/floor_plan_status \
  -H "Content-Type: application/json" \
  -d '{ "apiKey": "YOUR_API_KEY", "floorPlanId": "FLOOR_PLAN_ID" }'

Antwort

{
  "floorPlanId": "Ae6pgFD6yZyyhpzZH",
  "propertyId": "196e742a-5b0d-4c9e-8a3f-7e2b1c6d9f04",
  "name": "Ground floor",
  "status": "ready",
  "imageUrl": "https://img.pedra.ai/floorplan-source-QiqMn78cKtNHk4LpF",
  "appUrl": "https://app.pedra.ai/?projectId=196e742a-5b0d-4c9e-8a3f-7e2b1c6d9f04",
  "creditsUsed": 5
}

So wird der Grundriss gut

• Schreiben Sie mindestens ein echtes Maß auf die Zeichnung (eine Wandlänge oder die Gesamtfläche). Ohne Maß stimmt die Aufteilung, aber ohne Größenangaben.
• Beschriften Sie jeden Raum. Die Namen werden so übernommen, wie sie geschrieben sind.
• Fotografieren Sie das Blatt von oben, flach und gut beleuchtet. Bilder werden auf 2400 px an der langen Seite verkleinert, größere Dateien bringen also nichts.

Fehler

• 400 imageUrl fehlt oder die URL ist kein Bild.
• 403 nicht genug Credits (5 benötigt).
• 404 unbekannter API-Schlüssel oder eine propertyId / floorPlanId, die nicht zu diesem Konto gehört.
• 409 die Immobilie hat bereits 30 Grundrisse.
• 500 die Zeichnung konnte nicht gelesen werden. Es wird nichts abgebucht und kein Grundriss bleibt zurück.

Aus ChatGPT oder Claude

Dieselben Endpunkte sind die Tools pedra_create_floor_plan und pedra_get_floor_plan im Pedra-MCP-Server. Hängen Sie im Chat ein Foto der Skizze an und fragen Sie nach dem Grundriss.