Home staging virtual

API de home staging virtual

Amuebla habitaciones vacías, vacía habitaciones amuebladas, renueva espacios y edita interiores con prompts o máscaras — todas las operaciones sobre el contenido de la habitación en un solo sitio.

Los endpoints de home staging virtual cubren todo lo que cambia el contenido de una habitación: añadir muebles, eliminarlos, renovar el espacio, ediciones precisas con prompts y eliminación de objetos por máscara. Para limpieza de fotos (enhance, sky, blur), mira Mejora de imágenes.

Amueblar una habitación vacía

POST/api/furnish

Añade muebles realistas a una habitación vacía. Pedra preserva la arquitectura de la habitación (paredes, ventanas, puertas, suelos) y solo añade muebles y decoración.

Ejemplos de staging de interiores
Pares antes/después en salones, dormitorios, cocinas y oficinas en distintos estilos de muebles.
Ver ejemplos →

Parámetros

apiKeystringobligatorio
Tu clave API.
imageUrlstringobligatorio
URL de la foto de la habitación vacía, o un data URI base64 (data:image/png;base64,...).
roomTypestringobligatorio
Tipo de espacio a amueblar. Los ocho valores de abajo son los tipos de espacio predefinidos. También puedes pasar cualquier otro espacio como string personalizado (p. ej. "Kid's room", "Garden", "Home gym").
Values: Living room Dining + Living room Bedroom Dining room Terrace Entrance Office Bathroom
stylestringobligatorio
Estilo del mobiliario. Pasa uno de los estilos nombrados abajo, o una URL pública a una imagen de referencia (p. ej. una foto de Pinterest o de producto) — Pedra replicará el look de la referencia.
Values: Minimalist Modern Scandinavian Industrial Bohemian Mid-century modern Traditional Mediterranean Coastal Rustic Farmhouse Contemporary
creativitystring
Cuánta libertad toma la IA con el diseño. Medium es el valor recomendado; High usa un modelo más ligero y rápido. Medium cuesta 2 créditos por imagen, High cuesta 1 — mira Precios.
Values: Medium High
Default: Medium
propertyIdstring
Id opcional de la propiedad (de list_properties o create_property) a la que pertenece esta foto. Si se indica, el resultado se guarda en la galería de esa propiedad — visible y editable desde la app — en lugar de devolverse solo como una URL.

Petición de ejemplo

curl -X POST https://app.pedra.ai/api/furnish \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/empty-bedroom.jpg",
    "roomType": "Bedroom",
    "style": "Minimalist",
    "creativity": "Medium"
  }'

Respuesta de ejemplo

JSON
{
  "message": "Success",
  "output": [
    { "url": "https://img.pedra.ai/<generated-id>" }
  ]
}

Tiempo de respuesta: ~30 segundos por imagen.

Vaciar una habitación amueblada

POST/api/empty_room

Elimina muebles y objetos de una habitación dejando intacta la arquitectura. Útil cuando las fotos del anuncio se toman con las pertenencias del anterior propietario aún colocadas.

Ejemplos de declutter y vaciado
Mira anuncios reales transformados de desordenados a completamente vacíos en segundos.
Ver ejemplos →

Parámetros

apiKeystringobligatorio
Tu clave API.
imageUrlstringobligatorio
URL de la foto de la habitación amueblada, o un data URI base64.
propertyIdstring
Id opcional de la propiedad (de list_properties o create_property) a la que pertenece esta foto. Si se indica, el resultado se guarda en la galería de esa propiedad — visible y editable desde la app — en lugar de devolverse solo como una URL.

Petición de ejemplo

curl -X POST https://app.pedra.ai/api/empty_room \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/furnished-room.jpg"
  }'

Respuesta de ejemplo

JSON
{
  "message": "Success",
  "output": [
    { "url": "https://img.pedra.ai/<generated-id>" }
  ]
}

Tiempo de respuesta: ~30 segundos por imagen.

Renovar una habitación

POST/api/renovation

Muestra cómo podría quedar una habitación tras una renovación: nuevos acabados, cocinas actualizadas, baños renovados. Opcionalmente mantiene las ventanas en su sitio y vuelve a amueblar en la misma llamada.

Ejemplos de renovación virtual
Renders reales de renovación — cocinas anticuadas, baños cansados e interiores renovados en varios estilos.
Ver ejemplos →

Parámetros

apiKeystringobligatorio
Tu clave API.
imageUrlstringobligatorio
URL de la foto de la habitación a renovar.
stylestringobligatorio
Estilo de la renovación. Pasa uno de los estilos nombrados abajo o una URL pública a una imagen de referencia — Pedra replicará los acabados, paleta y look general de la referencia.
Values: Minimalist Modern Scandinavian Industrial Bohemian Mid-century modern Traditional Mediterranean Coastal Rustic Farmhouse Contemporary
preserveWindowsboolean
Mantén las ventanas en su posición original. Recomendado para anuncios fieles a la realidad.
Default: false
furnishboolean
Añade muebles a la habitación renovada en la misma llamada. Cuando es true, roomType es obligatorio.
Default: false
roomTypestring
Se usa cuando furnish es true. Por defecto "Auto" (Pedra detecta el espacio desde la imagen). Acepta los mismos tipos de espacio predefinidos que el endpoint furnish, además de cualquier espacio personalizado que escribas como string (p. ej. "Kid's room", "Garden", "Home gym").
Values: Living room Dining + Living room Bedroom Dining room Terrace Entrance Office Bathroom Auto
Default: Auto
creativitystring
Cuán agresiva es la renovación. Medium es el valor recomendado; High usa un modelo más ligero y rápido. Medium cuesta 2 créditos por imagen, High cuesta 1 — mira Precios.
Values: Medium High
Default: Medium
propertyIdstring
Id opcional de la propiedad (de list_properties o create_property) a la que pertenece esta foto. Si se indica, el resultado se guarda en la galería de esa propiedad — visible y editable desde la app — en lugar de devolverse solo como una URL.

Petición de ejemplo

curl -X POST https://app.pedra.ai/api/renovation \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/dated-kitchen.jpg",
    "style": "Modern",
    "preserveWindows": true,
    "furnish": true,
    "roomType": "Kitchen",
    "creativity": "Medium"
  }'

Respuesta de ejemplo

JSON
{
  "message": "Success",
  "output": [
    { "url": "https://img.pedra.ai/<generated-id>" }
  ]
}

Tiempo de respuesta: ~30 segundos por imagen.

Editar con prompt

POST/api/edit_via_prompt

Haz ediciones precisas descritas en lenguaje natural: "Add a modern chandelier", "Repaint the walls white", "Remove the rug". Lo mejor para arreglos puntuales que no encajan en otros endpoints.

Parámetros

apiKeystringobligatorio
Tu clave API.
imageUrlstringobligatorio
URL de la foto a editar, o un data URI base64.
promptstringobligatorio
Instrucción de edición en lenguaje natural. Sé específico — "add a beige sofa against the back wall" funciona mejor que "add furniture".
propertyIdstring
Id opcional de la propiedad (de list_properties o create_property) a la que pertenece esta foto. Si se indica, el resultado se guarda en la galería de esa propiedad — visible y editable desde la app — en lugar de devolverse solo como una URL.

Petición de ejemplo

curl -X POST https://app.pedra.ai/api/edit_via_prompt \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/living-room.jpg",
    "prompt": "Add a modern chandelier to the ceiling"
  }'

Respuesta de ejemplo

JSON
{
  "message": "Success",
  "output": {
    "url": "https://img.pedra.ai/<generated-id>"
  }
}

Tiempo de respuesta: ~15 segundos por imagen. Coste: 2 créditos por llamada. output es un objeto único.

Eliminar objeto

POST/api/remove_object

Elimina objetos específicos de una imagen usando una máscara. La máscara es una imagen aparte donde los píxeles blancos marcan lo que se elimina y los negros lo que se conserva. Úsalo cuando necesites un control quirúrgico frente a edit_via_prompt.

Ejemplos de eliminación de objetos
Misma galería que /api/empty_room — desorden, muebles y objetos eliminados de fotos reales de anuncios.
Ver ejemplos →

Parámetros

apiKeystringobligatorio
Tu clave API.
imageUrlstringobligatorio
URL de la foto original.
maskUrlstringobligatorio
URL de la imagen de máscara. Las zonas blancas se eliminan; las negras se conservan.
propertyIdstring
Id opcional de la propiedad (de list_properties o create_property) a la que pertenece esta foto. Si se indica, el resultado se guarda en la galería de esa propiedad — visible y editable desde la app — en lugar de devolverse solo como una URL.

Petición de ejemplo

curl -X POST https://app.pedra.ai/api/remove_object \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/cluttered-room.jpg",
    "maskUrl": "https://example.com/mask.png"
  }'

Respuesta de ejemplo

JSON
{
  "message": "Success",
  "output": {
    "url": "https://img.pedra.ai/<generated-id>"
  }
}

Tiempo de respuesta: ~15 segundos por imagen. output es un objeto único.

Siguiente

Mira Mejora de imágenes para enfoque, cambio de cielo y difuminado — o Errores y límites para gestionar fallos.