Cuadra AI - Connect, Train, and Deploy Your Custom AI Assistant

Credit Pools

Pool	Source	Behavior
Subscription	Monthly plan allocation	Resets on billing date
Purchased	One-time purchases	Never expires, rolls over

Consumption order: Subscription credits first, then purchased credits.

Check Balance

Dashboard

View credits at dashboard.cuadra.ai → Billing.

API

curl https://api.cuadra.ai/v1/usage \
  -H "Authorization: Bearer YOUR_TOKEN"

import httpx

response = httpx.get(
    "https://api.cuadra.ai/v1/usage",
    headers={"Authorization": "Bearer YOUR_TOKEN"}
)
usage = response.json()
print(f"Credits: {usage['credits']['available']} available")

const response = await fetch('https://api.cuadra.ai/v1/usage', {
  headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
});
const usage = await response.json();
console.log(`Credits: ${usage.credits.available} available`);

Response:

{
  "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"

import httpx

response = httpx.get(
    "https://api.cuadra.ai/v1/usage",
    params={"period": "month"},
    headers={"Authorization": "Bearer YOUR_TOKEN"}
)
print(response.json())

const response = await fetch('https://api.cuadra.ai/v1/usage?period=month', {
  headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
});
console.log(await response.json());

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.

Pricing

Plans and tiers

Usage API

Query usage data

Getting Started

API Reference

Guides

Billing

Credits

Credit Pools

Check Balance

Dashboard

API

Purchase Credits

When Credits Run Out

Monitor Usage

Reduce Costs

FAQ

How are credits calculated?

Do unused subscription credits roll over?

Can I get a refund for unused credits?

How do I set up low-balance alerts?

Pricing

Usage API

​Credit Pools

​Check Balance

​Dashboard

​API

​Purchase Credits

​When Credits Run Out

​Monitor Usage

​Reduce Costs

​FAQ

​How are credits calculated?

​Do unused subscription credits roll over?

​Can I get a refund for unused credits?

​How do I set up low-balance alerts?

​Related

Pricing

Usage API

Credit Pools

Check Balance

Dashboard

API

Purchase Credits

When Credits Run Out

Monitor Usage

Reduce Costs

FAQ

How are credits calculated?

Do unused subscription credits roll over?

Can I get a refund for unused credits?

How do I set up low-balance alerts?

Related