Reference

API pricing

The Pedra API is billed in credits. Most image endpoints cost 1–2 credits, edit via prompt costs 2 credits, and each non-static video frame costs 5.

The Pedra API runs on a simple credit system. Every account has a credit balance — each call deducts credits, and you top up at app.pedra.ai or via a custom contract for high volume.

Cost per call

Endpoint
Unit
Cost
/api/enhance
per image
1 credit
/api/enhance_and_correct_perspective
per image
1 credit
/api/furnish
per image
1 credit (2 with a reference-image style)
/api/empty_room
per image
1 credit
/api/renovation
per image
1 credit
/api/sky_blue
per image
1 credit
/api/edit_via_prompt
per image
2 credits
/api/remove_object
per image
1 credit
/api/blur
per image
1 credit
/api/create_video
per non-static frame
5 credits
/api/create_virtual_tour
per tour — sequential linking
1 credit per room, at least 3
/api/create_virtual_tour
per tour — smart linking
Same as sequential
/api/add_virtual_tour_scenes
per call — new rooms only
1 credit per new room, at least 3

Video frames using effect: "static" are free — only motion frames (zoom-in, zoom-out, transition) count toward your credit usage.

Virtual tours: AI room naming, linking: "none", update_virtual_tour, get_virtual_tour, list_virtual_tours, delete_virtual_tour and create_upload_link are free, and a tour build that fails is never charged.

Worked examples

  • 10 photos enhanced → 10 credits
  • 5 rooms furnished + 5 rooms renovated → 10 credits (1 × 5 + 1 × 5)
  • 5 rooms furnished in the style of a reference image → 10 credits (2 × 5)
  • 10 prompt edits → 20 credits
  • 6-frame video, all zoom-in → 30 credits
  • 6-frame video, 4 zoom-in + 2 static → 20 credits
  • 8-room virtual tour, sequential linking → 8 credits
  • 8-room virtual tour, smart linking → 8 credits

Monthly balance

Your monthly credit allowance depends on the plan you're on, refreshed on your billing date. See pedra.ai/pricing for the current plans and credit allotments. You can switch plans any time from app.pedra.ai → Settings → Subscription and credits.

Once your monthly credits are depleted, calls return HTTP 403 with the remaining-credits math in the error body (402 insufficient_credits on the virtual tour endpoints, with creditsRequired and creditsAvailable) — top up or upgrade at app.pedra.ai to continue before the next refresh.

Topping up & enterprise

Top up at app.pedra.ai, or email felix@pedra.ai for:

  • Volume discounts (10,000+ calls/month)
  • Annual billing
  • Bank transfer or custom invoicing
  • Dedicated capacity / SLA

What counts as a billable call

  • Successful HTTP 200 = credits deducted.
  • Auth failures (404 "User not found") and validation errors (400) do not consume credits.
  • 403 Insufficient credits (402 on the virtual tour endpoints) — by definition, no deduction.
  • For video, the credit cost is calculated up-front from your images array and checked before processing begins.

Next

See Errors & limits for the full failure model, or Authentication to get started.