What a credit is
Credits are the unit Duvi bills your account in. Every agent on the account draws on the same balance, on every channel, so there is one number to watch rather than one per agent.
The cost of a conversation depends on the model, the length of each exchange, and whether it is text or voice. A short answer from a small model costs a fraction of a long exchange with a large one, and voice costs more than text because it adds transcription and speech to the same answer. Studio shows the rate for the model you selected, and your plan sets the terms.
What consumes credits
An agent consumes credits when it handles a conversation, charged to the account that owns the agent rather than to whoever is talking to it. Setting an agent up, changing its configuration, and connecting a channel or a tool consume nothing.
Duvi records every charge against the agent and the channel it came from, which is what makes the breakdown in Studio possible.
Review usage
Billing shows four views over the credit ledger, each covering a time window you select.
| View | What it shows |
|---|---|
| Transactions | Every purchase, grant, usage, refund and adjustment, with the balance after each. |
| Usage series | Spent, added and event count per hour, day, week or month. |
| Usage summary | This window against the one before it, plus burn per day and days remaining. |
| Breakdown | The same spend split by agent or by channel. |
Days remaining divides your current balance by the average daily spend in the selected window.
Insufficient credits
Duvi checks the balance at two points. In both cases it refuses the request rather than returning a lower quality answer.
| Check | Result |
|---|---|
| Starting a conversation | Duvi refuses with an insufficient credits error. The widget does not open a conversation. |
| During a conversation | Duvi rejects the next message. A response already streaming completes. |
To avoid interruption, keep a buffer or turn on automatic top-up.
Automatic top-up
On Billing, Top up automatically buys more credits on your saved card when the balance runs low. It is off until you turn it on.
| Setting | What it means | Accepts |
|---|---|---|
| Top up below | The balance that triggers a purchase. | 1 to 5000 credits |
| Buy this many | Credits bought each time it fires. | 5 to 5000 credits |
Duvi records every attempt with its outcome and reason, and emails you when a charge fails rather than failing quietly. Repeated failures stop the attempts instead of retrying forever. The form shows how many failed, and saving again after you fix the card resets the count.