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 (25 / 100 / 500 / 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 |
voice_to_lead | 1 |
business_card_scan | 1 |
shift_brief | 1 |
handoff_summary | 1 |
segment_lookalike | 1 |
agenda_generate | 2 |
document_parse | 2 |
team_search | 0 |
If a feature’s cost changes, you’ll see it in your next monthly usage digest and on
the /billing/ai_usage dashboard.
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.
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