API credits & pricing
What each API operation costs in credits — standard and premium tiers.
Aginera bills the API by artifact: you hold credits, and billable operations draw them down at the rates below. Read-only calls are free. New accounts start with trial credits; when they run low you buy more. Check your live balance and the authoritative rate card any time:
curl -s https://api.aginera.ai/partner/v1/credits -H "Authorization: Bearer $TOKEN"
# → { "available": …, "rate_card": [ { "operation": "takeoff.page", "credits": 2.5 }, … ] }
POST /takeoffs (and other jobs) return an estimated_credits ceiling before any work starts — the final charge never exceeds it.
Standard tier
Available to every account. takeoffs:run is the only routinely billable scope; everything read-only is free.
| Operation | Credits | Notes |
|---|---|---|
document.ingest | 0 | Uploading / importing a drawing is free |
document.cad_convert | 100 | Per DWG/DXF converted to a viewable model |
takeoff.text_page | 0.5 | A page extracted from the text layer (no vision) |
takeoff.page | 2.5 | A page extracted with vision (standard) |
takeoff.job_min | 10 | Per-job minimum (a takeoff is never billed under this) |
estimate.generate | 50 | Per estimate created |
estimate.item_priced | 0.2 | Per line item priced |
export.standard | 0 | CSV / Excel / JSON export is free |
export.estimating_format | 20 | Per estimating-format export |
A typical standard electrical takeoff of a 10-page set costs about 25 credits (10 × takeoff.page), or less when pages come from the text layer.
Premium tier
Premium APIs return richer artifacts — UI-parity deep takeoffs, interior reveal imagery, and embeddable BIM and clash-detection views. They are not part of the standard tier:
- Monthly subscription required. Premium endpoints are enabled only while your account holds an active Aginera monthly subscription.
- Approval required. Premium scopes aren't granted on the normal consent screen — you request access and we enable it (see Requesting premium access).
- Paid credits only. Premium operations never draw from trial credits; they require a paid balance and bill at the rates below.
| Operation | Credits | Returns |
|---|---|---|
takeoff.deep_page | 10 / page | Deep takeoff — same multi-pass agent + measured routes as the Aginera app |
interior.reveal | 100 / project | Full reveal set: dollhouse, floor plan, room teasers, 360° tour URLs |
interior.walkthrough_video | 30 / video | Rendered walkthrough video from a reveal |
bim.generate | 50 / document | Coordination BIM model + an embeddable BIM viewer URL |
clash.run | 60 / document | Clash detection scene + an embeddable clash review URL |
share.embed_url | 0 | Minting/refreshing a BIM or clash embed URL is free |
Deep takeoff is billed per page at the deep rate whenever the agent path runs (about 4× a standard page); the embeddable BIM and clash URLs are free to generate — you pay for the model or clash run that produces them.
Requesting premium access
- Call any premium endpoint. Without access you receive
403 premium_access_requiredwith anext_step. - Request it —
POST /partner/v1/access-requestswith the capabilities you want (takeoffs:deep,interior:generate,bim:generate,clash:run). This notifies our team at support@aginera.ai. - We confirm your subscription and enable the scopes on your client. You'll be able to call the premium endpoints on your next token.
curl -s -X POST https://api.aginera.ai/partner/v1/access-requests \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"capabilities":["bim:generate","clash:run"],"note":"Embedding BIM + clash in our estimating tool"}'
# → 202 { "status": "received", "contact": "support@aginera.ai" }
Prefer to talk first? Email support@aginera.ai with your organization and the capabilities you need.