Propriétés

API Propriétés

Parcourez les biens d'un compte Pedra, lisez les URL de leurs photos pour les utiliser avec create_video et les endpoints d'édition, créez des biens et ajoutez-y des photos par URL.

Les propriétés sont la manière dont les photos sont organisées dans un compte Pedra. Ces endpoints permettent de parcourir les propriétés d'un utilisateur, de lire les URL des photos d'un propriété (pour les transmettre directement à create_video ou aux endpoints d'édition), de créer des propriétés et d'y ajouter des photos par URL — le serveur télécharge chaque URL et la stocke, donc n'importe quelle image publique fonctionne.

Les photos déjà dans le compte sont la source la plus simple pour une vidéo. Pour ajouter des fichiers locaux tout neufs (qui ne peuvent pas être envoyés via l'API), ouvrez le propriété dans Pedra via l'appUrl renvoyé par ces endpoints et téléversez-les là.

Lister les propriétés

POST/api/list_properties

Renvoie les propriétés du compte (les plus récents d'abord), chacun avec un nombre de photos et une appUrl.

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

Réponse

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

Lister les photos du propriété

POST/api/list_property_images

Renvoie les photos d'un propriété sous forme d'URL publiques img.pedra.ai — transmettez-les directement à create_video ou aux endpoints d'édition d'images.

apiKeystringobligatoire
Votre clé API.
propertyIdstringobligatoire
L'id du propriété (de list_properties ou 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" }'

Réponse

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

Créer un propriété

POST/api/create_property

Crée un propriété vide et renvoie son propertyId et son appUrl.

apiKeystringobligatoire
Votre clé API.
namestring
Nom du propriété, par ex. l'adresse de l'annonce. Optionnel.
curl -X POST https://app.pedra.ai/api/create_property \
  -H "Content-Type: application/json" \
  -d '{ "apiKey": "YOUR_API_KEY", "name": "Calle Mayor 12" }'

Réponse

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

Ajouter des photos à un propriété

POST/api/add_images_to_property

Ajoute des photos à un propriété par URL. Le serveur télécharge chaque URL et la stocke (donc n'importe quelle image https publique — ou une petite URI data: — fonctionne), puis renvoie les URL img.pedra.ai stockées. Jusqu'à 20 par appel.

apiKeystringobligatoire
Votre clé API.
propertyIdstringobligatoire
L'id du propriété (de list_properties ou create_property).
imageUrlsarrayobligatoire
Tableau d'URL d'images à télécharger et ajouter (max 20). Une seule chaîne imageUrl est aussi acceptée.
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"
    ]
  }'

Réponse

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

Suivant

Transmettez les URL des photos d'un propriété à create_video, ou utilisez-les avec n'importe quel endpoint de home staging virtuel / amélioration.