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 habitación a amueblar. Los ocho valores de abajo tienen prompts ajustados a mano; cualquier otro string (p. ej. "Kitchen", "Closet") también funciona mediante prompts generados automáticamente.
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

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://pedraimages.s3.eu-west-3.amazonaws.com/<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.

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://pedraimages.s3.eu-west-3.amazonaws.com/<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 la habitación desde la imagen). Mismo conjunto de valores que el endpoint furnish.
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

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://pedraimages.s3.eu-west-3.amazonaws.com/<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".

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://pedraimages.s3.eu-west-3.amazonaws.com/<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.

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://pedraimages.s3.eu-west-3.amazonaws.com/<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.