SDKs

SDKs oficiales de Python y JavaScript/TypeScript para la API de Pedra. Home staging virtual, renovación, mejora de imágenes y vídeos para anuncios en unas pocas líneas de código — cada método espera a que el recurso esté listo y devuelve la URL final.

SDKs oficiales

Dos clientes oficiales envuelven la API REST de Pedra. Ambos son de código abierto, no tienen dependencias en tiempo de ejecución y exponen todos los endpoints. Cada método espera a que el recurso esté listo y devuelve la(s) URL(s) final(es) — sin IDs de trabajo que consultar.

Instalación

Node.js

npm install @pedra-ai/sdk

Python

pip install pedra

Autenticación

Pasa tu clave al cliente o define la variable de entorno PEDRA_API_KEY. Obtén una clave registrándote en app.pedra.ai y abriendo Ajustes → API. Las claves son de larga duración — nunca las incluyas en código de cliente; llama desde tu backend. Mira Autenticación para más detalles.

from pedra import Pedra

# Reads PEDRA_API_KEY from the environment…
pedra = Pedra()

# …or pass the key explicitly
pedra = Pedra("YOUR_API_KEY")

Inicio rápido

Amuebla una habitación vacía. Todos los métodos de imagen devuelven la misma forma — usa url para el primer recurso o urls para todos.

from pedra import Pedra

pedra = Pedra()  # reads PEDRA_API_KEY

result = pedra.furnish(
    image_url="https://example.com/empty-living-room.jpg",
    room_type="Living room",
    style="Minimalist",
)

print(result.url)   # the staged image URL
print(result.urls)  # all generated URLs

Qué puedes llamar

Ambos SDKs cubren todos los endpoints de Pedra con los mismos nombres de método en cada lenguaje:

• furnish, empty, renovation, editViaPrompt, remove — mira Home staging virtual.
• enhance, enhanceAndCorrectPerspective, sky, blur — mira Mejora de imágenes.
• createVideo, updateVideo, generateVoiceScript, generateVoice, musicLibrary, además de credits y feedback — mira Vídeo y Créditos.
• listProperties, listPropertyImages, createProperty, addImagesToProperty — mira Propiedades.

Python usa snake_case (edit_via_prompt, create_video, update_video, generate_voice, music_library); los parámetros y el comportamiento son idénticos.

Manejo de errores

Ambos SDKs lanzan PedraApiError para fallos de la API (con status y body) y PedraError para errores de cliente o red. Mira Errores y límites para la lista completa de fallos.

Servidor MCP

¿Prefieres usar Pedra desde un asistente de IA? El servidor MCP oficial de Pedra expone las mismas operaciones a Claude, ChatGPT y Cursor, para que puedas hacer staging y editar fotos de anuncios directamente desde un chat.

Código y soporte

Ambos SDKs tienen licencia MIT y se desarrollan en abierto. Dale una estrella o abre issues en GitHub, y escribe a felix@pedra.ai para ayuda con la integración, mayores cuotas o condiciones enterprise.

Preguntas frecuentes