Documentación API de Pedra.so

API para crear imágenes de staging virtual de hogar

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

URLs Base

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

  • Production: https://app.pedra.so/api

Autenticación

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

Parámetros Comunes

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

  • apiKey (string, required): Tu clave API única para autenticación.
  • imageUrl (string, required): URL de la imagen a procesar.
  • creativity (string, required): Nivel de libertad creativa para la IA.
    • Low: Preserva la arquitectura original con variaciones mínimas.
    • Medium: Mantiene la arquitectura original con variaciones notables pero equilibradas.

Endpoints API

Ejecutar Mejora

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

Endpoint: /enhance

Method: POST

Parameters: Parámetros comunes (ver arriba)

Expected response time: Entre 25 segundos y 1 minuto

Ejecutar Habitación Vacía

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

Endpoint: /empty_room

Method: POST

Parameters: Parámetros comunes (ver arriba)

Expected response time: Entre 2 y 3 minutos

Ejecutar Amueblado

Amuebla (crea un staging virtual) de un espacio según parámetros especificados.

Endpoint: /furnish

Method: POST

Parameters: Parámetros comunes + roomType + style

Expected response time: Entre 2 y 3 minutos

Possible values for roomType:

  • "Dormitorio"
  • "Sala de estar"
  • "Cocina"
  • "Oficina"
  • "Terraza"
  • "Comedor"
  • "Cocina + Sala de estar"
  • "Comedor + Sala de estar"
  • "Entrada"

Possible values for style:

  • "Tradicional"
  • "Minimalista"
  • "Escandinavo"
  • "Mediados de siglo"
  • "Bohemio"
  • "Industrial"
  • "Mediterráneo"
  • "Moderno"
  • "Pirineos"

Ejecutar Renovación

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

Endpoint: /renovation

Method: POST

Parameters: Parámetros comunes + style + preserveWindows

Expected response time: Entre 25 segundos y 2 minutos

Formato de Respuesta

Todos los endpoints API devuelven respuestas JSON. Una respuesta exitosa tendrá un código de estado 200 e incluirá la información de 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 con la API, por favor contacta a nuestro equipo de soporte en <a href="mailto:felix@pedra.so" style="color: rgb(248, 121, 42); text-decoration: none;">felix@pedra.so</a>.