Every AI action in Dokly — inline edits, page generation, site generation — costs credits. Each plan includes a monthly credit bucket. If you run out, AI actions pause until the bucket resets or you move to a bigger plan.
How credits work#
- Credits are denominated in roughly "small-AI-action" units.
- Each plan includes a fixed monthly bucket that resets every 30 days.
- Unused credits don't roll over.
- When you run an action, credits are reserved upfront and refunded if the action fails.
Monthly buckets#
| Plan | Monthly credits | Approximate usage |
|---|---|---|
| Free | 15 | A handful of inline edits, or one generated page |
| Team | 1,500 | ~150 generated pages or 1,500 inline edits |
| Business | 6,000 | A small docs team's worth of generation |
| Enterprise | Custom or BYOK | See below |
Each action has a fixed credit cost, listed below.
Action costs#
Cost per action:
| Action | Credits |
|---|---|
| Inline edit (improve, expand, simplify, fix) | 1 |
| Generate from a short prompt | 1 |
| Generate single page | 10 |
| Generate a docs site from context | 50 |
The editor shows the cost preview before you confirm any large action.
Where to see your usage#
Settings → Account → AI usage shows:
- Current month's bucket and remaining
- Daily usage chart for the past 30 days
- Recent actions (per-action cost log)
Screenshot needed
screenshot of the AI usage panel showing the bucket meter, daily chart, and recent actions log
Running out#
If you exhaust your monthly bucket, the editor tells you you're out of credits instead of running the action. There are no paid top-ups today. Your options:
| Option | What you get |
|---|---|
| Wait for the reset | A full bucket again 30 days after the current period started |
| Move from Free to Team | 1,500 credits/month ($99/mo) |
| Move from Team to Business | 6,000 credits/month ($199/mo) |
Writing and editing by hand never costs credits, so running out never blocks your docs.
Why we meter AI separately#
Two reasons:
- AI is expensive. A power user generating 100 pages a month would otherwise drag down everyone else's plan price. Metering lets light users pay light prices.
- It's transparent. Every action has a fixed, published cost, and your usage panel shows exactly where credits went.
BYOK (Bring Your Own Key)#
On the Enterprise plan, you can connect your own Anthropic API key. AI actions then bill against your Anthropic account directly, and your Dokly bill drops the AI metering line item.
BYOK is enterprise-only because:
- It needs key management infrastructure (encryption, rotation, scoping).
- Most users don't have an Anthropic account or want to manage one.
- For smaller usage, our pooled allocation is cheaper than a direct AnthropicAPI bill.
If you're on Free or Team with high AI usage, the right move is usually moving up a plan (Team or Business), not BYOK.
Refunds and failures#
If an AI action fails (network error, model timeout, validation error), the credits are refunded automatically. You can verify in the recent actions log — failed actions show with a strikethrough and "refunded" tag.
If you ever see a charge for an action that didn't run, file an issue and we'll refund manually.