API reference

Pedra API

Programmatic access to virtual staging, image enhancement, and listing video generation. JSON over HTTPS. Built for real estate platforms, CRMs, and portals.

Base URL

All API requests are made to:

https://app.pedra.ai/api

Quickstart

Every endpoint accepts a JSON POST with your apiKey and an imageUrl. Here's a virtual staging call that furnishes an empty room:

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"
  }'

Successful responses return HTTP 200 with { "message": "...", "output": ... }. output is an array for /api/enhance, /api/enhance_and_correct_perspective, /api/empty_room, /api/furnish, and /api/renovation, and a single object for /api/sky_blue, /api/edit_via_prompt, /api/remove_object, and /api/blur. See Errors & limits for failure shapes.

Endpoints

See every endpoint in action
Browse before/after galleries for staging, renovation, enhancement, sky replacement, and video.
See examples →

Virtual staging →

POST/api/furnishAdd furniture to an empty room
POST/api/empty_roomRemove all furniture from a room
POST/api/renovationRenovate a room in a new style
POST/api/edit_via_promptEdit an image with a text prompt
POST/api/remove_objectRemove specific objects via mask

Image enhancement →

POST/api/enhanceAuto-enhance lighting, color, sharpness
POST/api/enhance_and_correct_perspectiveEnhance + straighten vertical lines
POST/api/sky_blueReplace a gray sky with blue
POST/api/blurBlur objects (faces, plates, logos)

Video →

POST/api/create_videoGenerate a listing video from photos

Account →

POST/api/creditsCheck remaining credit balance

Authentication

All requests require an apiKey in the JSON body. Get a key by signing up at app.pedra.ai and opening Settings → API. See Authentication for details.

Request & response format

Every endpoint accepts JSON over HTTPS via POST. Image inputs can be passed as a publicly accessible URL or as a base64 data URI (data:image/png;base64,...). Pedra times out after 20s when downloading imageUrl — for auth-walled or presigned URLs (S3, R2, Cloudinary), prefer the base64 form.

All endpoints are synchronous. Image endpoints respond in ~10–30 seconds; the video endpoint blocks for up to 10 minutes — set your HTTP client timeout accordingly.

Pricing

API usage is billed per request, with volume discounts. See Pricing.

Support

Email felix@pedra.ai for quota increases, integration help, or enterprise terms. We respond within one business day.