Credit Pools
| Pool | Source | Behavior |
|---|
| Subscription | Monthly plan allocation | Resets on billing date |
| Purchased | One-time purchases | Never expires, rolls over |
Check Balance
Dashboard
View credits at dashboard.cuadra.ai → Billing.
API
curl https://api.cuadra.ai/v1/usage \
-H "Authorization: Bearer YOUR_TOKEN"
{
"credits": {
"used": 15000,
"limit": 50000,
"available": 35000,
"purchasedBalance": 100000,
"totalAvailable": 135000,
"billingPeriod": "monthly",
"periodStart": "2025-01-01T00:00:00Z",
"periodEnd": "2025-01-31T23:59:59Z"
},
"storage": { "used": 524288000, "limit": 1073741824 },
"plan": { "tier": "pro", "name": "Professional" }
}
Purchase Credits
Dashboard → Billing → Purchase Credits.
Credit packages are available for Pro and Enterprise plans. See the Dashboard for current pricing.
Purchased credits never expire. Use them anytime.
When Credits Run Out
API returns HTTP 402 Payment Required:
{
"title": "Insufficient Credits",
"status": 402,
"detail": "Insufficient credits. Required: 75 credits. Available: 50 credits."
}
| Recovery Option | Action |
|---|
| Wait | Subscription resets monthly |
| Purchase | Buy credits instantly |
| Upgrade | Higher tier = more monthly credits |
Monitor Usage
curl "https://api.cuadra.ai/v1/usage?period=month" \
-H "Authorization: Bearer YOUR_TOKEN"
Reduce Costs
| Strategy | Impact |
|---|
| Use smaller models for simple tasks | Significant savings |
Set maxTokens limit | Caps response length |
| Keep system prompts concise | Fewer input tokens |
| Cache frequent responses | Avoid duplicate requests |
FAQ
How are credits calculated?
Credits are based on token usage. The exact formula depends on the model and request type. Each Chat API response includes token counts in the usage field.
Do unused subscription credits roll over?
No. Subscription credits reset on your billing date. Purchased credits roll over indefinitely.
Can I get a refund for unused credits?
Purchased credits are non-refundable. Contact support@cuadra.ai for billing questions.
How do I set up low-balance alerts?
Dashboard → Settings → Notifications. Set thresholds for email alerts.
