Documentación API de pedra.ai

API para crear imágenes de staging virtual de hogar

Bienvenido a la documentación oficial de la API de pedra.ai. 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.ai/api

Autenticación

Todas las llamadas API requieren un parámetro apiKey para autenticación. Envía un email a felix@pedra.ai 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 imagen (http/https) o URI de datos base64 (data:image/...).

Endpoints API

Mejorar

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

Endpoint: /enhance

Method: POST

Parameters:

{
  "apiKey": "string",
  "imageUrl": "string"
}

Expected response time: 25 segundos

Vaciar Habitación

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

Endpoint: /empty_room

Method: POST

Parameters:

{
  "apiKey": "string",
  "imageUrl": "string"
}

Expected response time: 25 segundos

Amueblar

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

Endpoint: /furnish

Method: POST

Parameters:

{
  "apiKey": "string",
  "imageUrl": "string",
  "roomType": "string",
  "style": "string",
  "creativity": "Medium" | "High"
}

Expected response time: 25 segundos

roomType (string):

You can write any room type (e.g., "Living room", "Bedroom", "Kitchen", "Office", etc.)

Example values for style:

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

Renovación

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

Endpoint: /renovation

Method: POST

Parameters:

{
  "apiKey": "string",
  "imageUrl": "string",
  "creativity": "Medium" | "High",
  "furnish": true | false,
  "style": "string",
  "roomType": "string"
}

Expected response time: 25 segundos

roomType and style:

Same options as the Furnish endpoint above.

Cielo Azul

Mejora el cielo en imágenes exteriores, haciéndolo aparecer azul y vibrante.

Endpoint: /sky_blue

Method: POST

Parameters:

{
  "apiKey": "string",
  "imageUrl": "string"
}

Expected response time: ~15 segundos

Editar con Prompt

Edita la imagen basándose en un prompt en lenguaje natural que describe los cambios deseados.

Endpoint: /edit_via_prompt

Method: POST

Parameters:

{
  "apiKey": "string",
  "imageUrl": "string",
  "prompt": "string"
}

Expected response time: ~20 segundos

Eliminar Objeto

Elimina objetos de la imagen usando una máscara para especificar qué áreas eliminar.

Endpoint: /remove_object

Method: POST

Parameters:

{
  "apiKey": "string",
  "imageUrl": "string",
  "maskUrl": "string"
}

Expected response time: ~15 segundos

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 felix@pedra.ai.