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.

SDKs y MCP

¿Prefieres un cliente tipado en lugar de HTTP directo? Los SDKs oficiales de Python y Node.js envuelven todos los endpoints — pip install pedra o npm i @pedra-ai/sdk. O usa Pedra directamente desde Claude, ChatGPT y Cursor con el servidor MCP. ¿Necesitas un contrato legible por máquinas? Descarga la especificación OpenAPI 3.1.

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
POST/api/feedbackValora una imagen y solicita la devolución de créditos

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.

Preguntas frecuentes

¿Pedra tiene API?

Sí. Pedra ofrece una API REST sobre JSON-over-HTTPS para home staging virtual, mejora de imágenes, eliminación de objetos y generación de vídeos de anuncios. Está pensada para plataformas inmobiliarias, CRMs y portales. Consigue una clave de API en app.pedra.ai en Ajustes → API.

¿Qué puede hacer la API de Pedra?

Expone todas las transformaciones de Pedra de forma programática: amueblar habitaciones vacías, vaciar habitaciones amuebladas, renovar espacios, editar fotos con una instrucción de texto, eliminar objetos, mejorar luz y color, corregir la perspectiva, sustituir cielos, difuminar contenido sensible y generar vídeos de anuncios.

¿Existe una API de home staging virtual?

Sí. POST /api/furnish añade muebles a habitaciones vacías, /api/empty_room los quita, /api/renovation cambia el estilo de un espacio y /api/edit_via_prompt edita una foto a partir de una instrucción en lenguaje natural, todo en una sola API JSON.

¿Cómo integro Pedra?

Crea una clave de API y luego instala un SDK oficial (pip install pedra o npm install @pedra-ai/sdk) o llama directamente a los endpoints REST. Pasa tu clave y la URL de una imagen a un endpoint; cada llamada espera hasta que el resultado está listo y devuelve la URL final, sin IDs de trabajo que consultar.

¿Cuánto cuesta la API de Pedra?

El precio es por generación correcta, con descuentos por volumen, y solo pagas por los resultados correctos. Hay una prueba gratuita disponible. Consulta la página de precios de la API para más detalles.

¿Cómo funciona la autenticación de la API de Pedra?

Pasas tu clave de API en el cuerpo de la petición, en el campo apiKey. Las claves son de larga duración, así que llama a la API desde tu backend y nunca incluyas una clave en código de cliente.