Immobilien-API

Durchsuchen Sie die Immobilien eines Pedra-Kontos, lesen Sie deren Foto-URLs für create_video und die Bearbeitungs-Endpunkte, erstellen Sie Immobilien und fügen Sie ihnen Fotos per URL hinzu.

Immobilien sind die Art, wie Fotos in einem Pedra-Konto organisiert sind. Diese Endpunkte erlauben es, die Immobilien eines Nutzers zu durchsuchen, die Foto-URLs eines Immobilie auszulesen (um sie direkt an create_video oder die Bearbeitungs-Endpunkte zu übergeben), Immobilien zu erstellen und ihnen Fotos per URL hinzuzufügen — der Server lädt jede URL und speichert sie, sodass jedes öffentliche Bild funktioniert.

Fotos, die bereits im Konto sind, sind die einfachste Quelle für ein Video. Neue Fotos kommen auf drei Wegen hinein: öffentliche URLs über add_images_to_property; lokale Dateien über denselben Endpunkt, als base64-data:-URIs gesendet; oder, wenn die Fotos auf dem Handy einer Person liegen, ein Upload-Link, über den sie ohne Login hochlädt.

Immobilien auflisten

Gibt die Immobilien des Kontos zurück (neueste zuerst), jeweils mit einer Fotoanzahl und einer appUrl.

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

Antwort

{
  "properties": [
    {
      "propertyId": "<uuid>",
      "name": "Calle Mayor 12",
      "createdAt": "2026-06-30T10:00:00.000Z",
      "photoCount": 8,
      "appUrl": "https://app.pedra.ai/?propertyId=<uuid>"
    }
  ]
}

Immobiliefotos auflisten

Gibt die Fotos eines Immobilie als öffentliche img.pedra.ai-URLs zurück — übergeben Sie sie direkt an create_video oder die Bildbearbeitungs-Endpunkte.

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

Antwort

{
  "propertyId": "<uuid>",
  "name": "Calle Mayor 12",
  "images": [
    {
      "imageId": "<uuid>",
      "url": "https://img.pedra.ai/<uuid>",
      "name": "Image 1",
      "aspectRatio": 1.5
    }
  ]
}

Ein Immobilie erstellen

Erstellt ein leeres Immobilie und gibt dessen propertyId und appUrl zurück.

curl -X POST https://app.pedra.ai/api/create_property \
  -H "Content-Type: application/json" \
  -d '{ "apiKey": "YOUR_API_KEY", "name": "Calle Mayor 12" }'

Antwort

{
  "message": "Property created",
  "propertyId": "<uuid>",
  "appUrl": "https://app.pedra.ai/?propertyId=<uuid>"
}

Fotos zu einem Immobilie hinzufügen

Fügt einem Immobilie Fotos per URL hinzu. Der Server lädt jede URL und speichert sie (sodass jedes öffentliche https-Bild — oder eine kleine data:-URI — funktioniert) und gibt dann die gespeicherten img.pedra.ai-URLs zurück. Bis zu 20 pro Aufruf.

Übergeben Sie type: "360", um stattdessen 360°-Fotos für einen virtuellen Rundgang hinzuzufügen: Jedes wird auf das equirektanguläre Format (2:1) geprüft und so gespeichert wie in der App, bis zu 10 pro Aufruf. data:-URIs funktionieren auch hier, sodass lokale 360°-Dateien base64-kodiert gesendet werden können — eine oder wenige pro Aufruf, unter dem Anfragelimit von 50 MB. Fotos, die keine 360°-Fotos sind, kommen mit Begründung in failed zurück.

Jedes hier gespeicherte Foto zählt zum täglichen Upload-Limit des Kontos: 30 pro Tag im Free-Tarif, 500 in bezahlten Tarifen. Darüber liefert der Aufruf 429 mit code: "upload_limit" und es wird nichts gespeichert; Fotos, die für sich scheitern, zählen nicht.

curl -X POST https://app.pedra.ai/api/add_images_to_property \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "propertyId": "PROPERTY_ID",
    "imageUrls": [
      "https://example.com/kitchen.jpg",
      "https://example.com/living-room.jpg"
    ],
    "names": ["IMG_0412.jpg", "IMG_0413.jpg"]
  }'

Antwort

{
  "message": "Added 2 image(s)",
  "propertyId": "<uuid>",
  "added": [
    { "imageId": "<uuid>", "url": "https://img.pedra.ai/<uuid>", "name": "IMG_0412.jpg", "aspectRatio": 1.5 }
  ],
  "failed": [],
  "appUrl": "https://app.pedra.ai/?propertyId=<uuid>"
}

Fotos vom Handy: Upload-Links

Wenn die Fotos auf dem Handy einer Person liegen — Makler, Fotograf, Eigentümer —, ist create_upload_link der einfachste Weg, sie in eine Immobilie zu bringen. Es liefert eine Seite ohne Login, 24 Stunden gültig, die bis zu 100 Fotos annimmt (JPEG, PNG, WebP und HEIC vom iPhone). Mit dem Standard type: "any" nimmt sie normale und 360°-Fotos an, und 2:1-Bilder werden automatisch als 360° gespeichert; type: "360" nimmt nur 360°-Fotos an.

Schicken Sie die uploadUrl an die Person; wenn sie fertig ist, rufen Sie list_property_images auf (type "photo" oder "360") und verwenden die URLs mit den Bearbeitungs-Endpunkten, create_video oder create_virtual_tour. Upload-Links sind kostenlos; Sie können 5 pro Tag im Free-Tarif und 50 in bezahlten Tarifen erstellen, und jede hochgeladene Datei zählt zum täglichen Upload-Limit. Vollständige Referenz: create_upload_link.

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

Weiter

Übergeben Sie die Foto-URLs eines Immobilie an create_video oder verwenden Sie sie mit einem beliebigen Home-Staging- / Verbesserungs-Endpunkt.