AI credits
Every AI feature in Lydira — inbox drafting, voice-to-lead, business-card scan, agenda generator, shift brief — debits from a single transparent credit pool. This page explains how that pool works.
Two pools per account
Your account carries two separate credit pools:
- Monthly allowance — fixed by your plan (100 / 500 / 1,000 / 2,000 / 5,000), resets on your billing anniversary.
- Wallet balance — purchased one-off via top-up packs. Never expires while your subscription is active.
AI calls deduct from the allowance first; once the allowance is empty, they draw from the wallet. When both reach zero, AI features pause cleanly — they never charge overage.
Per-feature cost
Each feature has a published cost in credits. Current map:
| Feature | Credits |
|---|---|
inbox_reply_drafter | 1 |
inbox_ingest | 1 |
email_parse | 1 |
voice_to_lead | 1 |
business_card_scan | 1 |
shift_brief | 1 |
handoff_summary | 1 |
segment_enrich | 1 |
segment_lookalike | 1 |
suggestions | 1 |
agenda_generate | 2 |
document_parse | 2 |
team_search | 0 |
Anything not listed costs 1 credit. Reading work that pulls a whole document apart — generating an agenda, parsing a booking PDF — costs 2.
If a feature’s cost changes, you’ll see it in your next monthly usage digest and on
the /billing/ai_usage dashboard.
Why semantic search is free
Search — “find me a similar trip”, “which customer is closest to this brief”, team
chat search — runs on an embedding model hosted on our own servers, not on a
third-party API. There is no per-call cost to pass on, and the text being searched
never leaves the platform. That is why team_search is 0 rather than a rounding
error we charge you for.
Top-ups
Four packs available, priced globally — AI is a global commodity, the same price everywhere:
- 100 credits — $9
- 500 credits — $39 (13% off)
- 2,000 credits — $139 (23% off)
- 10,000 credits — $599 (33% off)
Top-ups are one-off purchases. They never trigger a subscription change, and they credit your wallet balance immediately on webhook confirmation.
Auto-refill
Enable auto-refill on /billing/ai_wallet to have Lydira quietly buy a pack
when your wallet drops below a threshold. You set the threshold and the pack.
Auto-refill respects your monthly top-up cap if you’ve set one.
Self-hosted deployments
When SELF_HOSTED=true is set, the credit ledger is bypassed entirely — every AI
call returns :ok without metering, and you pay your AI provider (OpenAI) directly
at cost. No markup, no credit pool, no pause behaviour.
Turning AI off
Credits are only half the control. On /settings/ai you can switch AI off for the
whole account, disable individual features, block a whole data class (personal,
financial, operator-only), pin inference to EU-only providers, and record a lawful
basis per customer — choose “no processing” for someone and no AI call is ever made
about them. Every call that does happen is logged with its feature, its subject and
that basis, and personal data is tokenised before the prompt leaves.
Seeing your usage
- Top-nav meter — compact allowance/wallet badge on every authenticated page
/billing/ai_usage— full dashboard with today/month/year breakdowns, per-feature splits, burn-rate projection/billing/ai_wallet— transaction ledger, auto-refill + spend cap settings