Proprietà

API Proprietà

Sfoglia le proprietà di un account Pedra, leggi gli URL delle loro foto per usarli con create_video e gli endpoint di modifica, crea proprietà e aggiungivi foto tramite URL.

I proprietà sono il modo in cui le foto vengono organizzate in un account Pedra. Questi endpoint permettono di sfogliare i proprietà di un utente, leggere gli URL delle foto di un proprietà (per passarli direttamente a create_video o agli endpoint di modifica), creare proprietà e aggiungervi foto tramite URL — il server scarica ogni URL e la memorizza, quindi funziona qualsiasi immagine pubblica.

Le foto già nell'account sono la fonte più semplice per un video. Per aggiungere file locali nuovi (che non possono essere inviati tramite l'API), apri il proprietà in Pedra tramite l'appUrl che questi endpoint restituiscono e caricale lì.

Elencare i proprietà

POST/api/list_properties

Restituisce i proprietà dell'account (i più recenti prima), ciascuno con un conteggio foto e un appUrl.

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

Risposta

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

Elencare le foto del proprietà

POST/api/list_property_images

Restituisce le foto di un proprietà come URL pubblici img.pedra.ai — passale direttamente a create_video o agli endpoint di modifica immagini.

apiKeystringobbligatorio
La tua chiave API.
propertyIdstringobbligatorio
L'id del proprietà (da list_properties o create_property).
curl -X POST https://app.pedra.ai/api/list_property_images \
  -H "Content-Type: application/json" \
  -d '{ "apiKey": "YOUR_API_KEY", "propertyId": "PROPERTY_ID" }'

Risposta

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

Creare un proprietà

POST/api/create_property

Crea un proprietà vuoto e restituisce il suo propertyId e appUrl.

apiKeystringobbligatorio
La tua chiave API.
namestring
Nome del proprietà, ad es. l'indirizzo dell'annuncio. Opzionale.
curl -X POST https://app.pedra.ai/api/create_property \
  -H "Content-Type: application/json" \
  -d '{ "apiKey": "YOUR_API_KEY", "name": "Calle Mayor 12" }'

Risposta

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

Aggiungere foto a un proprietà

POST/api/add_images_to_property

Aggiunge foto a un proprietà tramite URL. Il server scarica ogni URL e la memorizza (quindi funziona qualsiasi immagine https pubblica — o un piccolo URI data:), poi restituisce gli URL img.pedra.ai memorizzati. Fino a 20 per chiamata.

apiKeystringobbligatorio
La tua chiave API.
propertyIdstringobbligatorio
L'id del proprietà (da list_properties o create_property).
imageUrlsarrayobbligatorio
Array di URL di immagini da scaricare e aggiungere (max 20). È accettata anche una singola stringa imageUrl.
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"
    ]
  }'

Risposta

JSON
{
  "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>"
}

Successivo

Passa gli URL delle foto di un proprietà a create_video, oppure usali con qualsiasi endpoint di home staging virtuale / miglioramento.