Referencia de la API

API de Pedra

Acceso programático a home staging virtual, mejora de imágenes y generación de vídeos inmobiliarios. JSON sobre HTTPS. Para portales, CRMs y plataformas inmobiliarias.

URL base

Todas las peticiones a la API se hacen a:

https://app.pedra.ai/api

Inicio rápido

Cada endpoint acepta un POST JSON con tu apiKey y una imageUrl. Aquí tienes una llamada de home staging virtual que amuebla una habitación vacía:

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

Las respuestas correctas devuelven HTTP 200 con { "message": "...", "output": ... }. output es un array para /api/enhance, /api/enhance_and_correct_perspective, /api/empty_room, /api/furnish y /api/renovation, y un objeto único para /api/sky_blue, /api/edit_via_prompt, /api/remove_object y /api/blur. Consulta Errores y límites para los formatos de fallo.

Endpoints

Ver cada endpoint en acción
Explora galerías de antes/después de home staging, renovación, mejora, cambio de cielo y vídeo.
Ver ejemplos →

Home staging virtual →

POST/api/furnishAñade muebles a una habitación vacía
POST/api/empty_roomElimina todo el mobiliario de una habitación
POST/api/renovationRenueva una habitación con un estilo nuevo
POST/api/edit_via_promptEdita una imagen con un prompt
POST/api/remove_objectElimina objetos específicos con una máscara

Mejora de imágenes →

POST/api/enhanceMejora automática de luz, color y nitidez
POST/api/enhance_and_correct_perspectiveMejora + endereza líneas verticales
POST/api/sky_blueSustituye un cielo gris por uno azul
POST/api/blurDifumina objetos (caras, matrículas, logos)

Vídeo →

POST/api/create_videoGenera un vídeo de anuncio a partir de fotos

Cuenta →

POST/api/creditsConsulta el saldo de créditos restante

Autenticación

Todas las peticiones requieren una apiKey en el cuerpo JSON. Obtén una clave registrándote en app.pedra.ai y abriendo Ajustes → API. Mira Autenticación para más detalles.

Formato de petición y respuesta

Cada endpoint acepta JSON sobre HTTPS vía POST. Las imágenes se pueden enviar como URL públicamente accesible o como data URI base64 (data:image/png;base64,...). Pedra hace timeout a los 20s al descargar la imageUrl — para URLs con autenticación o pre-firmadas (S3, R2, Cloudinary), usa el formato base64.

Todos los endpoints son síncronos. Los endpoints de imagen responden en ~10–30 segundos; el endpoint de vídeo bloquea hasta 10 minutos — configura el timeout del cliente HTTP en consecuencia.

Precios

El uso de la API se factura por petición, con descuentos por volumen. Mira Precios.

Soporte

Escribe a felix@pedra.ai para aumentar cuotas, recibir ayuda con la integración o condiciones enterprise. Respondemos en un día laborable.