Three-tier credit model
Credits live at three levels. Each level has its own balance, its own usage counter, and clear rules for how it can be funded.Account
The balance of an organization that runs several Digital Twins. Funded by the Praxis AI team and by credits released back from its Digital Twins; moved down to Digital Twins by transfer.
Digital Twin
The Digital Twin’s own balance: 50 credits to start, then purchases by its admins and transfers from the parent Account. Drawn down by member activity when it pools credits.
User
Personal balance attached to each person: 50 credits to start, then personal purchases and a Digital Twin’s welcome award. Drawn down whenever the person works outside a pooled Digital Twin.
Credit pooling
Each Digital Twin has a Pool Credits flag that decides who pays for member activity.Pool Credits ON (default)
Pool Credits ON (default)
All members of the Digital Twin draw from the twin’s balance. A user with zero personal credits can still chat freely as long as the twin has credits. This is the standard setup for schools, classrooms, and corporate teams.
Pool Credits OFF
Pool Credits OFF
Each member pays from their personal credit balance. The twin’s balance is not consumed by member chat. Use this when you want the Digital Twin to provide branding and configuration but each user is responsible for their own usage.
Manual transfer
Account Managers can move credits between an Account and any of its Digital Twins at any time, in either direction, whatever the transfer mode.1
Open the account
Go to Admin → Accounts, open the account, then its Instances tab.
2
Choose the transfer
Select the transfer icon on the Digital Twin’s row, enter the amount, and reverse the direction if the credits should go back to the account.
3
Confirm
The balances are updated immediately and a transfer record is written so the move shows up in the audit trail.
Automatic top-up — Transfer Modes
Each Account has a Transfer to Instances setting (Credit Transfers in the Studio UI) that decides whether Pria refills a Digital Twin by itself and whether the Digital Twin’s own admins may pull credits. The three choices, as the classic edit form names them:Never
No automatic movement. Account Managers make every transfer by hand. Use this for strict per-twin budgeting.
By Instance Admins
No automatic refill either, but the admins of a Digital Twin that pools credits can pull 1,000 credits from the Account themselves (classic Add Credits page) while the Account holds more than 1,000.
Automatically on low credits
When a Digital Twin with Pool Credits ON falls below the low-balance threshold, Pria automatically pulls credits from the parent Account.
How automatic top-up works
When Transfer Credits Mode = Automatically on low credits and a pooled Digital Twin hits the threshold:1
Trigger
The Digital Twin’s balance falls to 500 credits or below during an interaction.
2
Transfer amount
Pria pulls up to 1,000 credits from the parent Account — capped at whatever the Account currently has available.
3
Apply
The Account is debited, the Digital Twin is credited, and a transfer record is written with mode Auto.
When a Digital Twin is deleted
Deleting a Digital Twin does not burn its credits. Any remaining balance returns to the parent Account so it can be redistributed to other Digital Twins (the move is recorded in the transfer ledger with mode Deletion). If the deleted Digital Twin has no parent Account, the remaining balance is credited to the administrator who performed the deletion.Awarded credits
A Digital Twin that does not pool credits can award welcome credits to brand-new accounts when they first join. The award comes out of the Digital Twin’s own balance (a join is refused if it cannot cover it) and is recorded on the person’s membership.Use cases
Welcome bonus for new members of a non-pooled Digital Twin, so they can start chatting before purchasing.
Audit
Each award is timestamped and tied to the membership record, so you can audit who received what and when.
Trial credits and conversion
New accounts start with 50 free credits. They behave like purchased credits and do not expire.When the balance runs out, the person sees a prompt to add credits. Their account stays active; only chat is gated. Credits bought afterwards land on the same balance and clear the gate at once.
Watching the balance
Pria does not email admins when a pooled Digital Twin runs low. Watch the balance under Instance Settings → Billing and on the account’s Instances tab, where the usage bar turns orange above 65% and red above 85%. With Automatically on low credits, the Account refills the Digital Twin at 500 credits or fewer, as long as the Account has credits left.Reading the audit trail
Every credit movement that involves an Account writes a transfer record. Together these form the canonical ledger for your organization’s credit movements.
You can review transfer history in the account’s Credit Transfers tab. Filter by Digital Twin to investigate a specific Digital Twin’s funding history.
User quotas
Beyond pooling and balances, you can cap how much any single member is allowed to consume. User quotas protect a shared pool from a runaway user and give each member a predictable budget. There are two per-user caps:Per-user lifetime
The maximum credits a single user may consume in this Digital Twin, total. Once reached, that user is blocked until an Admin raises the cap. Leave blank (or
0) for no cap.Per-user 24-hour
The maximum credits a single user may consume in any rolling 24-hour window. This cap recovers automatically as recent usage ages out — no Admin action needed. Leave blank (or
0) for no cap.Account vs. Digital Twin precedence
Quotas can be owned at two levels, and the rule is simple — the Account always wins:Account owns the quotas
Account owns the quotas
When the parent Account has credit caps enabled, those caps apply to every Digital Twin under it. The Digital Twin shows the quotas read-only — you can see them but not change them. Account-level quotas also include an account-wide cumulative per-user cap that is not available at the Digital Twin level.
The Digital Twin configures its own
The Digital Twin configures its own
When the Account has not enabled caps, each Digital Twin can configure its own per-user lifetime and 24-hour quotas. This is the common case for a standalone Digital Twin that wants to budget its members.
Who can edit and where
Any admin with theinstitutions.edit entitlement can set them:
- Instance Settings → Quotas tab — the in-product panel for a Digital Twin’s own Admins.
- Admin → Configuration (the Digital Twin editor) — the same controls in the management console.
Per-member consumption
To see how much each member of a Digital Twin has actually consumed, open Admin → Entitlements — the classic membership list has a Credit Consumed column (in the Studio UI, open a membership and look at its Usage tab). It counts pooled consumption only. This is the fastest way to spot heavy consumers in a pooled Digital Twin before the balance runs low.Related
- Billing & Subscriptions — purchasing credits via Stripe
- Accounts Overview — Account structure and ownership
- Credits — user-facing view of credit usage
- Plans & Credits — package pricing and the credit math