Sovariq credits and limits
How many Sovariq credits you have, how a run spends them live, what happens at zero, and the limits your organization and Sovaria can set for each member, project and organization.
On Sovaria's models, Sovariq is measured in Sovariq credits, never dollars per call. A quick chat turn is about 0.3 credit, a build step on Sonnet about 6 and a typical app build a few hundred; the meter shows one decimal. Your plan includes a monthly amount with a daily share; Sovaria can add a custom allowance or a grant; and your organization's owners and admins can narrow what each member and project may use. Runs on your own model key use no credits.
#The meter
The Sovariq message box shows what you can use now, for example 1,240 left today · 8,900 this month. It drops after every model call while Sovariq works, turns amber when 20% or less is left and red at zero. Click it for the breakdown: plan credits today and this month, granted credits and packs, any cap your admin set for you or for this project, the current run so far and the last run's actual against its estimate ("used 312 of the 400 estimated").
Anywhere else: Sovariq › Settings › Usage shows your own line on top, sov ai credits prints it, and Sovariq can check it itself (its credits_left tool) before a large build.
#How a run spends credits
Estimate and hold
Before the first model call Sovariq estimates the run (an approved app plan uses the plan's own estimate) and Sovaria holds that many credits for it, never more than you have left. Two runs can't both take the last credits.
Charge each call
Each model call is charged as soon as it returns, at the model's credit price (cache reads at their lower price). The meter shows what is left after that call.
Settle
When the run ends the unused part of the hold is released and you see the actual next to the estimate. A run that never finishes releases its hold after 30 minutes.
#Running low and running out
At 20% left Sovariq says so once in the conversation. At zero a running build pauses before its next model call, with "Top up or ask your admin", and keeps everything it already did. Once credits exist again (tomorrow's daily share, a top-up, a grant, a higher cap) say continue or press Retry and it picks up where it stopped. A new message with no credits left doesn't start at all.
| Code | Meaning |
|---|---|
AI_CREDIT_USED | The organization used its credits for today (ai.credits_day) or this month (ai.credits_month). |
AI_MEMBER_CAP | You used the daily or monthly credits your admin set for you (or for every member). |
AI_PROJECT_CAP | This project used the credits your admin set for it. |
AI_ACCESS_DENIED | Your organization lets only owners and admins, or chosen members, use Sovariq. |
Streams carry these as plan_limit events, and a credit stop also as {"type": "paused", "paused": {"reason": "credits"}}. Every usage event on Sovaria's key has a credits block (used_run, left_today, left_month, level).
#Where credits come from
- Your plan: a monthly amount with a daily share (table below). The daily share refills at midnight UTC, the month on the 1st.
- A custom allowance set by Sovaria: any monthly and daily amount, or unlimited, until an end date. It replaces the plan's amounts while it lasts; plan prices don't change.
- Grants and packs: extra credits with an expiry. They are used once the day's or month's plan credits are gone, soonest expiry first, and no daily share applies to them.
- Credit packs you buy (paid plans): 1,000, 5,500 or 23,000 credits for 12 months, from your wallet (within the monthly Sovariq wallet cap) or by card or UPI under Billing › Wallet & cap, or
sov ai buy-pack. Prices are on the pricing page. - Welcome credits on Free: 100 once, for 30 days, on your first organization (verified email).
- Per-build ceiling: an app build pauses at your plan's ceiling (
ai.build_credit_ceiling) until you press Continue; a build stuck repeating the same step stops with a report instead of spending more.
| Free | Pro | Ultra | Team | Enterprise | |
|---|---|---|---|---|---|
| Sovariq credits per month (Sovaria's own AI: Sovariq and managed embeddings; 1 credit ≈ one short reply) | 30 | 250 | 1,500 | 8,000 | 10,000 |
| Sovariq credits per day for the whole organization (a share of the month, so one day can't use it all) | 10 | 100 | 400 | 2,000 | 2,000 |
| One-time welcome Sovariq credits (first Free organization) | 100 | — | — | — | — |
| Sovariq credits one app build may use before it asks to continue | 60 | 600 | 2,000 | 5,000 | 20,000 |
#Limits your organization sets
Owners and admins open Organization › Sovariq limits. Sovaria enforces these itself, before every run and after every model call, not just in the console. Everyone can see them, and each person is told the limits that apply to them ("Your admin set 500 credits a day for you").
- Who can use Sovariq: everyone, owners and admins only, or chosen members (owners and admins always can). This also applies on your own model key.
- Default for members: a daily and/or monthly cap for every member without their own, including people who join later.
- Per member: a daily and/or monthly cap for one person.
- Per project: a cap on everything Sovariq does in a project, whoever asks, project agents included.
sov ai credits
sov ai packs
sov ai buy-pack starter --from-wallet
sov ai limits
sov ai limits set-member <user-id> --day 500
sov ai limits set-project <project-id> --month 5000
sov ai limits set-default --month 2000
sov ai limits access selected --user <user-id>