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.

SDKs & MCP

Prefer a typed client over raw HTTP? The official Python and Node.js SDKs wrap every endpoint — pip install pedra or npm i @pedra-ai/sdk. Or call Pedra straight from Claude, ChatGPT, and Cursor via the MCP server. Need a machine-readable contract? Download the OpenAPI 3.1 spec.

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
POST/api/feedbackVote on an image and request credit back

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.

Frequently asked questions

Does Pedra have an API?

Yes. Pedra offers a JSON-over-HTTPS REST API for virtual staging, image enhancement, object removal, and listing-video generation. It's built for real estate platforms, CRMs, and portals. Get an API key at app.pedra.ai under Settings → API.

What can the Pedra API do?

It exposes every Pedra transformation programmatically: furnish empty rooms, empty furnished rooms, renovate spaces, edit photos with a text prompt, remove objects, enhance lighting and color, correct perspective, replace skies, blur sensitive content, and generate listing videos.

Is there a virtual staging API?

Yes. POST /api/furnish adds furniture to empty rooms, /api/empty_room removes it, /api/renovation restyles a space, and /api/edit_via_prompt edits a photo from a plain-English instruction — all in one JSON API.

How do I integrate Pedra?

Create an API key, then install an official SDK (pip install pedra or npm install @pedra-ai/sdk) or call the REST endpoints directly. Pass your key and an image URL to an endpoint; each call blocks until the result is ready and returns the final URL — there are no job IDs to poll.

How much does the Pedra API cost?

Pricing is per successful generation with volume discounts, and you only pay for successful results. A free trial is available. See the API pricing page for details.

How does Pedra API authentication work?

You pass your API key in the request body as the apiKey field. Keys are long-lived, so call the API from your backend and never ship a key in client-side code.