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. Um brandneue lokale Dateien hinzuzufügen (die nicht über die API gesendet werden können), öffnen Sie das Immobilie in Pedra über die von diesen Endpunkten zurückgegebene appUrl und laden Sie sie dort hoch.

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.

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"
    ]
  }'

Antwort

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

Weiter

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