Propiedades

API de propiedades

Explora las propiedades de una cuenta de Pedra, lee las URLs de sus fotos para usarlas en create_video y los endpoints de edición, crea propiedades y añádeles fotos por URL.

Los propiedades son la forma en que se organizan las fotos en una cuenta de Pedra. Estos endpoints te permiten explorar los propiedades de un usuario, leer las URLs de las fotos de un propiedad (para pasarlas directamente a create_video o a los endpoints de edición), crear propiedades y añadirles fotos por URL — el servidor descarga cada URL y la almacena, así que funciona cualquier imagen pública.

Las fotos que ya están en la cuenta son la fuente más fácil para un vídeo. Para añadir archivos locales nuevos (que no se pueden enviar por la API), abre el propiedad en Pedra mediante el appUrl que devuelven estos endpoints y súbelos allí.

Listar propiedades

POST/api/list_properties

Devuelve los propiedades de la cuenta (más recientes primero), cada uno con un recuento de fotos y un appUrl.

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

Respuesta

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

Listar fotos del propiedad

POST/api/list_property_images

Devuelve las fotos de un propiedad como URLs públicas img.pedra.ai — pásalas directamente a create_video o a los endpoints de edición de imágenes.

apiKeystringobligatorio
Tu clave API.
propertyIdstringobligatorio
El id del propiedad (de 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" }'

Respuesta

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

Crear un propiedad

POST/api/create_property

Crea un propiedad vacío y devuelve su propertyId y appUrl.

apiKeystringobligatorio
Tu clave API.
namestring
Nombre del propiedad, p. ej. la dirección del anuncio. Opcional.
curl -X POST https://app.pedra.ai/api/create_property \
  -H "Content-Type: application/json" \
  -d '{ "apiKey": "YOUR_API_KEY", "name": "Calle Mayor 12" }'

Respuesta

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

Añadir fotos a un propiedad

POST/api/add_images_to_property

Añade fotos a un propiedad por URL. El servidor descarga cada URL y la almacena (así que funciona cualquier imagen https pública — o una pequeña URI data:), y devuelve las URLs img.pedra.ai almacenadas. Hasta 20 por llamada.

apiKeystringobligatorio
Tu clave API.
propertyIdstringobligatorio
El id del propiedad (de list_properties o create_property).
imageUrlsarrayobligatorio
Array de URLs de imagen para descargar y añadir (máx. 20). También se acepta un único string 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"
    ]
  }'

Respuesta

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

Siguiente

Pasa las URLs de las fotos de un propiedad a create_video, o úsalas con cualquier endpoint de home staging virtual / mejora.