Producto
Precio

Documentación de la API de Pedra.so

API para crear imágenes de decoración virtual de hogares

Bienvenido a la documentación oficial de la API de Pedra.so. Nuestra API proporciona potentes capacidades de procesamiento de imágenes para diversas tareas de mejora y diseño de habitaciones.


URLs Base

Se puede acceder a la API a través de la siguiente URL base:

  • Producción: https://app.pedra.so/api

Autenticación

Todas las llamadas a la API requieren un parámetro apiKey para la autenticación. Envía un correo electrónico a felix@pedra.so para solicitar tu clave de API.


Parámetros Comunes

Los siguientes parámetros son comunes a todos los endpoints:

  • apiKey (string, obligatorio): Tu clave de API única para autenticación.
  • imageUrl (string, obligatorio): URL de la imagen a procesar.

Endpoints

Ejecutar Mejora

Mejora la calidad, el color, la luz y la resolución de la imagen proporcionada.

Endpoint: /enhance

Método: POST

Parámetros: Parámetros comunes (ver arriba)

Tiempo de respuesta esperado: Entre 25 segundos y 1 minuto


Ejecutar Habitación Vacía

Elimina muebles y objetos de la habitación en la imagen proporcionada.

Endpoint: /empty_room

Método: POST

Parámetros: Parámetros comunes (ver arriba)

Tiempo de respuesta esperado: Entre 2 y 3 minutos


Ejecutar Amueblado

Amuebla (crea una decoración virtual) de un espacio según los parámetros especificados.

Endpoint: /furnish

Método: POST

Parámetros:

  • Parámetros comunes (ver arriba)
  • roomType (string, obligatorio): Tipo de habitación a amueblar.
  • style (string, obligatorio): Estilo de diseño a aplicar.

Tiempo de respuesta esperado: Entre 2 y 3 minutos

Valores posibles para roomType:

  • "Bedroom" (Dormitorio)
  • "Living room" (Sala de estar)
  • "Kitchen" (Cocina)
  • "Office" (Oficina)
  • "Terrace" (Terraza)
  • "Dining room" (Comedor)
  • "Kitchen + Living room" (Cocina + Sala de estar)
  • "Dining + Living room" (Comedor + Sala de estar)
  • "Entrance" (Entrada)

Valores posibles para style:

  • "Traditional" (Tradicional)
  • "Minimalist" (Minimalista)
  • "Scandinavian" (Escandinavo)
  • "Mid-century" (Mediados de siglo)
  • "Bohemian" (Bohemio)
  • "Industrial" (Industrial)
  • "Mediterranean" (Mediterráneo)
  • "Modern" (Moderno)
  • "Pyrenees" (Pirineos)

Ejecutar Renovación

Renueva una habitación según el estilo especificado.

Endpoint: /renovation

Método: POST

Parámetros:

  • Parámetros comunes (ver arriba)
  • style (string, obligatorio): Estilo de diseño a aplicar para la renovación.
  • preserveWindows (boolean, obligatorio): Si se deben preservar las ventanas existentes durante la renovación.

Tiempo de respuesta esperado: Entre 25 segundos y 2 minutos


Formato de Respuesta

Todos los endpoints de la API devuelven respuestas JSON. Una respuesta exitosa tendrá un código de estado 200 e incluirá la información de la imagen procesada.


Manejo de Errores

En caso de error, la API devolverá un código de estado HTTP apropiado junto con una respuesta JSON que contiene detalles del error.


Soporte

Para cualquier pregunta o problema relacionado con la API, por favor contacta a nuestro equipo de soporte en felix@pedra.so.