Credits and automatic recharge
How usage is paid for: your included allowance, prepaid credits that never expire, metered overage, and automatic recharge with a monthly cap.
On this page
Everything in Duun is shown in dollars. “Credits” is simply the name for money you’ve paid in advance. Tokens and machine minutes only appear as the explanation of a cost, never as a separate unit you have to convert.
What uses credits
- Model calls: the tokens agents read and write.
- Compute: cloud sandboxes and desktops, billed per second while they run. Idle machines stop on their own and cost nothing.
Some usage never touches your balance:
- Your own model keys. With Bring your own keys on in Settings → Models, model calls bill to your provider account. Duun records an estimate so you can see the full cost, and charges $0 for those calls. See Models and BYOK.
- Machines you own. Local worktrees and SSH computers show as “owned” in usage and cost Duun nothing.
The order usage is paid in
- Included usage from your plan, which resets each period.
- Prepaid credits, which never expire.
- Metered overage, if you’ve turned it on. It’s billed on your next invoice and can have a cap. If overage is off, runs pause when credits reach $0.
You can see each balance in Settings → Billing & usage → Credits.
Buy credits
- Open Settings → Billing & usage → Credits and click Buy credits.
- Pick an amount, or enter your own.
- Check the card under Charge to, or choose Use another card.
- Confirm the purchase. You’ll see Credits added. If runs were paused because credits ran out, Duun offers to resume them.
Only Admins and Billing members can buy credits.
Turn on automatic recharge
Automatic recharge buys credits when your balance runs low, so runs don’t pause.
- Open Settings → Billing & usage → Credits.
- Under Automatic recharge, click Turn on. You need a card on file first. If there isn’t one, click Add a card.
- Set When balance falls below and the amount to buy each time.
- Set a Monthly cap: the most automatic recharge can spend in a month.
- Save. The summary reads like “Buy $500 when below $200 · up to $2,000/mo” (example values).
Each recharge sends a notification and appears in the credits history.
When automatic recharge stops
| What you see | What it means | What to do |
|---|---|---|
| Recharge declined · automatic recharge paused | The card was declined | Update the card in Payment. Runs continue until the balance is empty. See Fix a failed payment. |
| Monthly cap reached · no recharge | Recharges hit your monthly cap | Raise the cap, buy credits manually, or wait for next month |
| Automatic recharge off · runs pause when credits run out | It’s turned off | Turn it on, or turn on metered overage |