Usage & Credits
Understand how credits work and monitor your consumption.
Credit System
Cuneiform Chat uses credits (called Platform Credits) to measure usage:
- AI queries — When your agents answer questions
- Document processing — When documents are uploaded and indexed
- Embeddings — Vector generation for search
How Credits Are Used
AI Queries
Each time your agent answers a question:
- Credits are consumed based on the AI model used
- Longer responses may use slightly more credits
- Failed queries don't consume credits
Document Processing
When you upload documents:
- Credits are used to extract and process content
- Larger documents use more credits
- Re-processing uses additional credits
Viewing Usage
Access your usage from Settings → Billing → Usage:
- Current period usage — Credits used this billing cycle
- Remaining credits — Available credits
- Usage breakdown — By category (queries, processing, etc.)
Usage by Category
| Category | Description |
|---|---|
| AI Queries | Agent responses to user questions |
| Document Processing | Uploading and indexing documents |
| Embeddings | Vector generation for search |
Monitoring Usage
Usage Dashboard
The dashboard shows:
- Real-time credit balance
- Daily consumption trends
- Projected usage for the period
Usage Warnings
The platform automatically displays warnings as you approach your limits:
| Threshold | What Happens |
|---|---|
| ~80% used | Warning banner appears in dashboard |
| 100% used | "Limit Reached" banner with upgrade prompt |
| Blocked | Service paused until next period or upgrade |
These warnings appear automatically — no configuration needed.
Review your usage weekly to catch unexpected spikes early and optimize as needed.
Optimizing Credit Usage
Efficient Agents
- Write clear system prompts for accurate first responses
- Tune retrieval settings to reduce unnecessary searches
- Use appropriate response length settings
Smart Document Management
- Upload only necessary documents
- Remove outdated content
- Avoid duplicate documents
Usage Patterns
- Monitor which agents use the most credits
- Identify high-volume time periods
- Optimize based on patterns
What Happens at Limits
Approaching Limits
As you near your credit limit, warning banners appear in your dashboard prompting you to upgrade or enable extra usage.
Exceeding Limits
Depending on your plan:
- Service may pause until the next period
- Overage charges may apply
- Upgrade to continue immediately
Credit History
View historical usage:
- Previous billing periods
- Usage trends over time
- Breakdown by month
Billing Period
- Credits reset at the start of each billing period
- Your billing date is shown in account settings
- Unused credits may not roll over (check your plan)
Questions?
For usage questions:
- Review the Plans & Pricing page
- Check Manage Subscription for upgrades
- Contact support for billing inquiries