Credits

Overview

CAVOS Agents uses a credit system denominated in USD. Credits are deducted per API request based on model pricing and token usage.

Balance Requirements

• Minimum balance: $0.50 to make API requests
• Credits never expire
• Balance is shared across all API keys and agents

Top Up Credits

Add credits via Stripe checkout:

1. Navigate to Settings > Credits in the dashboard
2. Enter the amount to add
3. Complete payment via Stripe
4. Credits are added instantly to your balance

Cost Calculation

Each request cost is calculated as:

cost = (prompt_tokens × prompt_price / 1,000,000)
     + (completion_tokens × completion_price / 1,000,000)

Where prompt_price and completion_price are the model’s per-million-token rates.

Transaction History

Every credit change is recorded as a transaction:

Type	Description
PURCHASE	Stripe top-up
USAGE	API/agent usage deduction
REFUND	Credit refund
ADJUSTMENT	Manual adjustment

Each transaction records the amount, resulting balance, model used, and tokens consumed.

Agent Budget Limits

Control per-agent spending with budget limits:

Daily Budget

Maximum USD an agent can spend per day. Resets at midnight UTC.

Monthly Budget

Maximum USD an agent can spend per calendar month. Resets on the 1st.

Budget Check Flow

1. Before execution, the system checks:
   • Is the estimated cost within the daily budget?
   • Is the estimated cost within the monthly budget?
   • Does the user have sufficient credit balance?
2. If any check fails, the execution is rejected with a reason:
   • daily_limit — Daily budget exceeded
   • monthly_limit — Monthly budget exceeded
   • insufficient_credits — Not enough credits

Setting Budget Limits

Configure budgets in the agent settings:

{
  "dailyBudget": 5.00,
  "monthlyBudget": 50.00
}

Set to null to remove a limit.

Budget Status

Monitor agent spending:

Field	Description
dailyUsage	Amount spent today
monthlyUsage	Amount spent this month
dailyRemaining	Remaining daily budget
monthlyRemaining	Remaining monthly budget
totalCostIncurred	All-time total spend