DuckVizCredits
How AI features are billed in DuckViz.
DuckViz uses a credit-based system for AI features. Data handling (upload, SQL, dashboards, exports) is always free — credits only apply to server-side AI calls.
For purchasing credit packs and switching quality tiers, see Billing & Plans.
What's free
These features don't consume any credits:
- File uploads and data ingestion
- Manual SQL queries in the SQL workspace
- Viewing data in the data grid
- Dashboard layout changes (drag, resize, rearrange)
- Exporting reports / decks as PDF, DOCX, or PPTX
- Using the CLI to push files
- All persistence (your session restoring after refresh)
Per-action cost
Base costs on the Standard tier. The Premium tier multiplies every row by 5×.
| Action | Standard | Premium |
|---|---|---|
| Widget generation (default) | 3 | 15 |
| ↳ cache hit | 0 | 0 |
| Auto-fix broken SQL | 1 | 5 |
| Prompt-to-SQL (one-off ask) | 1 | 5 |
| Prompt suggestions | 1 | 5 |
| Detect log format | 1 | 5 |
| Generate report (all sections) | 5 | 25 |
| Modify report section (AI chat) | 2 | 10 |
| Generate deck (all slides) | 3 | 15 |
| Modify deck slide | 2 | 10 |
| Clarify drawer (ambiguous asks) | 0 | 0 |
Endpoint-keyed view of the same costs, plus rate limits, lives in the API endpoints reference.
A typical end-to-end run — generate widgets, build a dashboard, write a report — costs ~16 credits on Standard or ~80 on Premium. The 100 welcome credits cover ~5–6 Standard reports, or about one Premium report.
Cache hits are free
DuckViz answers from cache or from a curated template catalog whenever it can. Credits are only deducted when a request actually reaches the AI — every upstream hit refunds automatically, and you'll see the 0 charge in usage history.
Failed requests are refunded
If an AI request fails, times out, hits the rate limiter, or returns an unusable response, credits are refunded automatically. Credits are deducted before the request runs and refunded the moment anything goes wrong, so you're never charged for a request that didn't deliver.
Checking your balance
Your current balance appears in the header badge at the top of the app. Click it for a usage history drawer showing every deduction and refund.
Programmatic check is also available — see GET /api/credits/balance in the API reference.
Credit restoration
If a platform-side bug deducts credits without delivering results and the auto-refund didn't fire, we restore them manually. Email support@duckviz.com with the approximate time and the action you ran.
See the Refund Policy for the legal details.